Skip to navigation
API ReferenceProcess

Update Functional Team

Change a functional team. A slug another team of the workspace already has is 409 conflict, and nothing is changed; its own slug is fine.

Authentication

AuthorizationBearer

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

Path parameters

teamIdstringRequired

Request

This endpoint expects an object.
namestringOptional
slugstringOptional

A slug 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
404
Not Found Error
409
Conflict Error
422
Validation Error
429
Too Many Requests Error