Teams

Create Team Endpoint

post

Endpoint to create a team.

Args: team: The team to create. user: The authenticated user. rbac: RBAC component. db: The DB session.

Returns: Model of the created team.

Authorizations

Body

Model for creating teams.

namestring · min: 1 · max: 50Required

descriptionstring · min: 1 · max: 256Optional

organization_idstring · uuidRequired

Responses

application/json

objectOptional

Model for viewing teams.

application/json

post

HTTPcURLJavaScriptPython

POST /teams HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 93

{
  "name": "text",
  "description": "text",
  "organization_id": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "name": "text",
  "description": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created": "2025-04-21T16:49:05.607Z",
  "updated": "2025-04-21T16:49:05.607Z",
  "member_count": 1
}

Get Team Endpoint

get

Endpoint to get a team.

Args: team_id: ID of the team to get. user: The authenticated user. rbac: RBAC component. db: The DB session.

Returns: Model of the team.

Authorizations

Path parameters

team_idstring · uuidRequired

Responses

application/json

objectOptional

Model for viewing teams.

application/json

get

HTTPcURLJavaScriptPython

GET /teams/{team_id} HTTP/1.1
Host: 
Accept: */*

{
  "name": "text",
  "description": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created": "2025-04-21T16:49:05.607Z",
  "updated": "2025-04-21T16:49:05.607Z",
  "member_count": 1
}

Delete Team Endpoint

delete

Endpoint to delete a team.

Args: team_id: ID of the team to delete. user: The authenticated user. rbac: RBAC component. db: The DB session.

Authorizations

Path parameters

team_idstring · uuidRequired

Responses

application/json

anyOptional

application/json

delete

HTTPcURLJavaScriptPython

DELETE /teams/{team_id} HTTP/1.1
Host: 
Accept: */*

No content

Update Team Endpoint

patch

Endpoint to update a team.

Args: team_id: ID of the team to update. update: The team update. user: The authenticated user. rbac: RBAC component. db: The DB session.

Returns: Model of the updated team.

Authorizations

Path parameters

team_idstring · uuidRequired

Body

Model for updating teams.

namestring · min: 1 · max: 50Optional

descriptionstring · min: 1 · max: 256Optional

Responses

application/json

objectOptional

Model for viewing teams.

application/json

patch

HTTPcURLJavaScriptPython

PATCH /teams/{team_id} HTTP/1.1
Host: 
Content-Type: application/json
Accept: */*
Content-Length: 36

{
  "name": "text",
  "description": "text"
}

{
  "name": "text",
  "description": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created": "2025-04-21T16:49:05.607Z",
  "updated": "2025-04-21T16:49:05.607Z",
  "member_count": 1
}