POST Teams (store)

Developing

POST

/api/teams

Create a new team within the current tenant's organization. The team is automatically assigned the next available sort_order position. Optionally specify a parent_id to create a sub-team under an existing team.

The data field accepts arbitrary JSON for extensible team metadata. New teams are created with is_active: true.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

🟠422Unprocessable Entity

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-dev.commandroom.ai/api/api/teams' \
--header 'Authorization: Bearer {{token}}' \
--header 'X-Tenant-UUID: ' \
--header 'Content-Type: application/json' \
--data '{
  "name": "Sample Name",
  "description": "Sample description text.",
  "parent_id": 1,
  "data": {}
}'

Response Example

201 - OK

{
  "success": true,
  "data": {
    "id": 1,
    "name": "Sample Name",
    "description": "Sample description text.",
    "level": 1,
    "parent_id": 1,
    "is_active": true,
    "sort_order": 1,
    "data": {},
    "tasks_count": 10,
    "has_children": true,
    "children": [
      {}
    ]
  }
}

Modified at 2026-07-02 04:47:16

Multiplai Dev - Teams

GET Item (show)