Skip to main content
POST
Create team

Authorizations

X-API-Key
string
header
required

Owner-typed API key (ORGANIZATION, PERSON, VALUE_UNIT). Manage org-scoped lifecycle with /v1/public-api-keys; cross-org governance is restricted to /v1/sys/public-api-keys.

Body

application/json

Create payload for a team. Resolve people via GET /v1/public/people and value units via GET /v1/public/value-units.

name
string
required
Maximum string length: 150
Pattern: \S
externalId
string

Optional external system identifier.

Maximum string length: 255
Example:

"TEAM_platform_team"

leadId
string

Optional lead person id. Resolve via GET /v1/public/people.

Example:

"2f6db7d4-6e6c-4d4f-90f2-cbaac8441f7b"

deputyLeadId
string

Optional deputy lead person id. Resolve via GET /v1/public/people.

Example:

"5d6b7f5a-41b4-4c1e-a4fb-1dd3d89b5f68"

memberIds
string[]

Optional member person ids. Resolve via GET /v1/public/people.

Maximum array length: 12
valueUnitIds
string[]

Optional value unit ids. Resolve via GET /v1/public/value-units.

sprintIds
string[]

Optional sprint ids.

Response

Team created

id
string
name
string
externalId
string
leadId
string
leadName
string
deputyLeadId
string
deputyLeadName
string
memberIds
string[]
memberNames
string[]
valueUnitIds
string[]
valueUnitNames
string[]
deleted
boolean
sprintIds
string[]
sprintNames
string[]