Agents Team
API endpoints for Agents Team
GET
/api/agents/{agent_id}/team List returns agent team members.
Returns list of users assigned to the agent with their access levels. To get available workspace members for assignment, use the workspace team endpoint: GET /workspaces/:id/team
Response Codes
| Status Code | Description |
|---|---|
| 200 | Success |
| 404 | Resource not found |
Success
Response response.AgentTeamResponse
Agent Team
| Property | Type | Description |
|---|---|---|
| members[].user_id | integer (int64) | Unique user identifier |
| members[].name | string | User's full name |
| members[].email | string | User's email address |
| members[].avatar | string | null | URL to user's avatar image |
| members[].access_level | string | Access level: viewer or editor |
| members[].assigned_at | string (date-time) | Timestamp when user was assigned to agent |
POST
/api/agents/{agent_id}/team Create assigns a user to an agent team.
Creates an agent member record giving the user access to the agent. Returns the updated list of assigned members.
Request Body request.AgentMember
Agent Member
| Property | Type | Description |
|---|---|---|
| user_id* | integer (int64) | |
| access_level* | "viewer" | "editor" |
Response Codes
| Status Code | Description |
|---|---|
| 201 | Resource created successfully |
| 404 | Resource not found |
| 422 | Validation failed |
| 500 | Internal server error |
Resource created successfully
Response response.AgentTeamResponse
Agent Team
| Property | Type | Description |
|---|---|---|
| members[].user_id | integer (int64) | Unique user identifier |
| members[].name | string | User's full name |
| members[].email | string | User's email address |
| members[].avatar | string | null | URL to user's avatar image |
| members[].access_level | string | Access level: viewer or editor |
| members[].assigned_at | string (date-time) | Timestamp when user was assigned to agent |
DELETE
/api/agents/{agent_id}/team/{user_id} Delete removes a user from an agent team.
Deletes the agent member record, revoking the user's access to the agent. Returns the updated list of assigned members.
Response Codes
| Status Code | Description |
|---|---|
| 200 | Success |
| 400 | Invalid request |
| 404 | Resource not found |
| 500 | Internal server error |
Success
Response response.AgentTeamResponse
Agent Team
| Property | Type | Description |
|---|---|---|
| members[].user_id | integer (int64) | Unique user identifier |
| members[].name | string | User's full name |
| members[].email | string | User's email address |
| members[].avatar | string | null | URL to user's avatar image |
| members[].access_level | string | Access level: viewer or editor |
| members[].assigned_at | string (date-time) | Timestamp when user was assigned to agent |