Skip to navigation
API ReferenceProcess

Create Functional Team

Create a functional team. Its slug is kept as given, never suffixed: one another team of the workspace already has is 409 conflict, and nothing is created. A deleted team’s slug can be taken again.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
namestringRequired
slugstringRequired

Lowercase letters, digits and hyphens, up to 60. Used as given: one another team of the workspace already has is 409 conflict.

guidancestringOptional
colorstringOptional
sortOrderintegerOptional

Response

This endpoint returns an object.
idstring
organizationIdstring
namestring
slugstring

Unique among the workspace’s functional teams. A team created in LaunchCal without one gets it from its name, with -2, -3… when that is taken, and team when the name has no Latin letters or digits. A deleted team’s slug is free again.

colorstring
sortOrderinteger
memberUserIdslist of strings

The people put on the team by name, longest-standing first. With memberOrgTeamIds, they are offered first when one of its steps is given a reviewer. An app admin of LaunchCal chooses them in LaunchCal → Define your process → Functional teams; a key sets them with PUT /teams/functional/{teamId}/members.

memberOrgTeamIdslist of strings
The organizational teams on the team. Everyone on one of them, and on the teams inside it, is on this team too.
guidancestringOptional
Markdown shown to launchers and reviewers on the review page.

Errors

403
Forbidden Error
409
Conflict Error
422
Validation Error
429
Too Many Requests Error