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

OAuth2ComboScheme

OAuth2clientCredentialsRequired

Token URL:

---

OAuth2authorizationCodeRequired

Authorization URL: Token URL: Refresh URL:

Body

application/json

Model for creating teams.

namestring · min: 1 · max: 50Required

descriptionany ofOptional

string · min: 1 · max: 256Optional

or

nullOptional

organization_idstring · uuidRequired

Responses

200

Successful Response

application/json

Model for viewing teams.

namestring · min: 1 · max: 50Required

descriptionany ofOptional

string · min: 1 · max: 256Optional

or

nullOptional

idstring · uuidRequired

createdstring · date-timeRequired

updatedstring · date-timeRequired

member_countintegerRequired

422

Validation Error

application/json

post

/teams

HTTPcURLJavaScriptPython

POST /teams HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
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": "2026-04-02T14:28:15.180Z",
  "updated": "2026-04-02T14:28:15.180Z",
  "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

OAuth2ComboScheme

OAuth2clientCredentialsRequired

Token URL:

---

OAuth2authorizationCodeRequired

Authorization URL: Token URL: Refresh URL:

Path parameters

team_idstring · uuidRequired

Responses

200

Successful Response

application/json

Model for viewing teams.

namestring · min: 1 · max: 50Required

descriptionany ofOptional

string · min: 1 · max: 256Optional

or

nullOptional

idstring · uuidRequired

createdstring · date-timeRequired

updatedstring · date-timeRequired

member_countintegerRequired

422

Validation Error

application/json

get

/teams/{team_id}

HTTPcURLJavaScriptPython

GET /teams/{team_id} HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
Accept: */*

{
  "name": "text",
  "description": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created": "2026-04-02T14:28:15.180Z",
  "updated": "2026-04-02T14:28:15.180Z",
  "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

OAuth2ComboScheme

OAuth2clientCredentialsRequired

Token URL:

---

OAuth2authorizationCodeRequired

Authorization URL: Token URL: Refresh URL:

Path parameters

team_idstring · uuidRequired

Responses

200

Successful Response

application/json

anyOptional

422

Validation Error

application/json

delete

/teams/{team_id}

HTTPcURLJavaScriptPython

DELETE /teams/{team_id} HTTP/1.1
Authorization: Bearer YOUR_OAUTH2_TOKEN
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

OAuth2ComboScheme

OAuth2clientCredentialsRequired

Token URL:

---

OAuth2authorizationCodeRequired

Authorization URL: Token URL: Refresh URL:

Path parameters

team_idstring · uuidRequired

Body

application/json

Model for updating teams.

nameany ofOptional

string · min: 1 · max: 50Optional

or

nullOptional

descriptionany ofOptional

string · min: 1 · max: 256Optional

or

nullOptional

Responses

200

Successful Response

application/json

Model for viewing teams.

namestring · min: 1 · max: 50Required

descriptionany ofOptional

string · min: 1 · max: 256Optional

or

nullOptional

idstring · uuidRequired

createdstring · date-timeRequired

updatedstring · date-timeRequired

member_countintegerRequired

422

Validation Error

application/json

patch

/teams/{team_id}

HTTPcURLJavaScriptPython

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

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

{
  "name": "text",
  "description": "text",
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "created": "2026-04-02T14:28:15.180Z",
  "updated": "2026-04-02T14:28:15.180Z",
  "member_count": 1
}