조직 내 팀 생성

(POST) /v1/team

조직에 새로운 팀을 생성합니다.

---

Request

Headers

이름	값	타입	필수여부
Content-Type	application/json; charset=utf-8	String	O
X-OUTCODE-API-KEY	팀을 생성할 조직 API 키	String	O
X-OUTCODE-USER-API-KEY	생성할 팀을 담당할 가상 사용자 API 키	String	O

Body Params

이름	값	타입	필수여부
name	팀 이름	String	O

---

Response

201 (Success)

새로운 팀이 생성되며 생성된 팀의 정보를 반환합니다.

이름	값	타입
success	팀 생성 결과 (true: 성공 / false: 실패)	Boolean
code	status code	Number
timestamp	API 호출 일시 (UTC)	Date
message	API 실행 결과	String
data	생성된 팀 정보	Object
data.organization_id	팀이 속한 조직 ID	Number
data.name	생성된 팀 이름	String
data.domain	팀이 속한 조직의 도메인	String
data.id	팀 ID	Number
data.timezone	팀 설정 타임존 (기본값 : Asia/Seoul)	Enum
data.created_date	팀 생성일시 (UTC)	Date
data.deleted_date	팀 삭제일시 (UTC)	Date | null

400 (Failure)

팀 생성 개수를 초과한 경우입니다.

이름	값	타입
success	팀 생성 결과 (true: 성공 / false: 실패)	Boolean
code	status code	Number
timestamp	API 호출 일시 (UTC)	Date
message	실패 사유 메세지	String

401 (Failure)

유효한 조직 API 키가 아닙니다.

이름	값	타입
success	팀 생성 결과 (true: 성공 / false: 실패)	Boolean
code	status code	Number
timestamp	API 호출 일시 (UTC)	Date
message	실패 사유 메세지	String

403 (Failure)

Request Body 의 내용이 없거나 잘못된 경우입니다.

이름	값	타입
success	팀 생성 결과 (true: 성공 / false: 실패)	Boolean
code	status code	Number
timestamp	API 호출 일시 (UTC)	Date
message	실패 사유 메세지	String

5xx (Failure)

처리중 서버 내에서 오류가 발생한 경우에 발생됩니다.

이름	값	타입
success	팀 생성 결과 (true: 성공 / false: 실패)	Boolean
code	status code	Number
timestamp	API 호출 일시 (UTC)	Date
message	실패 사유 메세지	String