Teams API¶

Manage teams in Tessera.

List Teams¶

GET /api/v1/teams

Response¶

{
  "results": [
    {
      "id": "team-uuid",
      "name": "data-platform",
      "created_at": "2025-01-01T10:00:00Z",
      "member_count": 5,
      "asset_count": 25
    }
  ]
}

Get Team¶

GET /api/v1/teams/{team_id}

Response¶

{
  "id": "team-uuid",
  "name": "data-platform",
  "created_at": "2025-01-01T10:00:00Z",
  "members": [
    {
      "id": "user-uuid",
      "name": "John Doe",
      "email": "john@example.com",
      "role": "team_admin"
    }
  ]
}

Create Team¶

POST /api/v1/teams

Request Body¶

{
  "name": "analytics"
}

Response¶

{
  "id": "new-team-uuid",
  "name": "analytics",
  "created_at": "2025-01-15T10:00:00Z"
}

Update Team¶

PATCH /api/v1/teams/{team_id}

Request Body¶

{
  "name": "analytics-team"
}

Delete Team¶

DELETE /api/v1/teams/{team_id}

Returns 204 No Content on success.

Warning

Deleting a team will orphan its assets. Reassign assets first.

Get Team Assets¶

GET /api/v1/teams/{team_id}/assets

List all assets owned by the team.

Get Team Registrations¶

GET /api/v1/teams/{team_id}/registrations

List all contracts the team is registered as a consumer of.

API Keys¶

API keys are managed via the dedicated API Keys endpoint.

Create keys with the team ID:

POST /api/v1/api-keys

{
  "name": "CI Pipeline Key",
  "team_id": "team-uuid",
  "scopes": ["read", "write"]
}

See API Keys for full documentation.