Agent Teams
GET /api/orgs/{org_id}/agent-teams
Section titled “GET /api/orgs/{org_id}/agent-teams”List Teams
List all agent teams in the organization. Requires membership.
Omit limit to get every team; total is the full count either way.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| limit | query | integer | no | Max rows to return (1-100). Omit to return every row. |
| offset | query | integer | no | Rows to skip — pass the previous response’s next_offset. |
| org_id | path | string (uuid) | yes |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | Successful Response | Page_TeamResponse_ |
| 422 | Validation Error | HTTPValidationError |
POST /api/orgs/{org_id}/agent-teams
Section titled “POST /api/orgs/{org_id}/agent-teams”Create Team
Create a new agent team. Requires ADMIN or OWNER role.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| org_id | path | string (uuid) | yes |
Request body (required)
| Field | Type | Required | Description |
|---|---|---|---|
| avatar_seed | string | no | |
| description | string | no | |
| name | string | yes | |
| shared_allowed_tools | string[] | no | |
| shared_instruction | string | no | |
| shared_mounted_skills | string[] | no |
Responses
| Status | Description | Body |
|---|---|---|
| 201 | Successful Response | TeamResponse |
| 422 | Validation Error | HTTPValidationError |
GET /api/orgs/{org_id}/agent-teams/{team_id}
Section titled “GET /api/orgs/{org_id}/agent-teams/{team_id}”Get Team
Get an agent team by UUID or slug. Requires membership.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| org_id | path | string (uuid) | yes | |
| team_id | path | string | yes |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | Successful Response | TeamResponse |
| 422 | Validation Error | HTTPValidationError |
PATCH /api/orgs/{org_id}/agent-teams/{team_id}
Section titled “PATCH /api/orgs/{org_id}/agent-teams/{team_id}”Update Team
Update an agent team. Requires ADMIN or OWNER role.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| org_id | path | string (uuid) | yes | |
| team_id | path | string | yes |
Request body (required)
| Field | Type | Required | Description |
|---|---|---|---|
| avatar_seed | string | no | |
| description | string | no | |
| name | string | no | |
| shared_allowed_tools | string[] | no | |
| shared_instruction | string | no | |
| shared_mounted_skills | string[] | no |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | Successful Response | TeamResponse |
| 422 | Validation Error | HTTPValidationError |
DELETE /api/orgs/{org_id}/agent-teams/{team_id}
Section titled “DELETE /api/orgs/{org_id}/agent-teams/{team_id}”Delete Team
Delete an agent team. Agents become ungrouped. Requires ADMIN or OWNER role.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| org_id | path | string (uuid) | yes | |
| team_id | path | string | yes |
Responses
| Status | Description | Body |
|---|---|---|
| 204 | Successful Response | |
| 422 | Validation Error | HTTPValidationError |
GET /api/orgs/{org_id}/agent-teams/{team_id}/memories
Section titled “GET /api/orgs/{org_id}/agent-teams/{team_id}/memories”List Team Memories
List memories owned by this team. Requires org membership.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| org_id | path | string (uuid) | yes | |
| team_id | path | string | yes |
Responses
| Status | Description | Body |
|---|---|---|
| 200 | Successful Response | TeamMemoryListResponse |
| 422 | Validation Error | HTTPValidationError |
POST /api/orgs/{org_id}/agent-teams/{team_id}/memories
Section titled “POST /api/orgs/{org_id}/agent-teams/{team_id}/memories”Create Team Memory
Create a memory owned by this team. Requires ADMIN or OWNER role.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| org_id | path | string (uuid) | yes | |
| team_id | path | string | yes |
Request body (required)
| Field | Type | Required | Description |
|---|---|---|---|
| content | string | yes |
Responses
| Status | Description | Body |
|---|---|---|
| 201 | Successful Response | AgentMemoryResponse |
| 422 | Validation Error | HTTPValidationError |
DELETE /api/orgs/{org_id}/agent-teams/{team_id}/memories/{memory_id}
Section titled “DELETE /api/orgs/{org_id}/agent-teams/{team_id}/memories/{memory_id}”Delete Team Memory
Delete a team memory. Requires ADMIN or OWNER role.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| memory_id | path | string (uuid) | yes | |
| org_id | path | string (uuid) | yes | |
| team_id | path | string | yes |
Responses
| Status | Description | Body |
|---|---|---|
| 204 | Successful Response | |
| 422 | Validation Error | HTTPValidationError |
PUT /api/orgs/{org_id}/agent-teams/reorder
Section titled “PUT /api/orgs/{org_id}/agent-teams/reorder”Reorder Teams
Reorder teams by setting display_order. Requires membership.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| org_id | path | string (uuid) | yes |
Request body (required)
| Field | Type | Required | Description |
|---|---|---|---|
| team_ids | string (uuid)[] | yes |
Responses
| Status | Description | Body |
|---|---|---|
| 204 | Successful Response | |
| 422 | Validation Error | HTTPValidationError |