List agent teams¶
List teams and versions readable by the current identity.
GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/agent-teams
Before you call this API¶
BASE_URL uses the product API prefix https://api.moi.matrixorigin.cn/v5. For a dedicated deployment, use its corresponding product API address.
Prepare product identity and object identifiers in the same environment.
Request¶
curl --request GET \
"$BASE_URL/workspaces/$WORKSPACE_ID/agent-teams?limit=50&offset=0" \
--header "X-API-Key: $MOI_KEY" \
--header "X-Workspace-ID: $WORKSPACE_ID"
Next-page example:
curl --request GET \
"$BASE_URL/workspaces/$WORKSPACE_ID/agent-teams?limit=50&offset=50" \
--header "X-API-Key: $MOI_KEY" \
--header "X-Workspace-ID: $WORKSPACE_ID"
Parameter |
Location |
Type |
Required |
Description |
|---|---|---|---|---|
|
Path |
string |
Yes |
Current Workspace ID, consistent with the product identity and request headers in the same environment. |
|
Query |
string |
No |
Name or description search text. |
|
Query |
string |
No |
active/deleting/deleted. Omit to skip this filter. |
|
Query |
integer |
No |
Default 50, maximum 200. Nonpositive or invalid values use 50. |
|
Query |
integer |
No |
Default 0; negative values use 0. |
In ordinary mode, stop when offset + items.length >= total or items is empty. Concurrent writes may affect offset pagination; total is not a stable snapshot.
query matches names or descriptions case-insensitively. status matches the saved state. Omitting status does not automatically exclude deleted. Read scope is filtered before total and pagination are calculated.
Successful response¶
{
"code": 0,
"data": {
"items": [
{
"id": "team-example",
"workspace_id": "workspace-example",
"owner_user_id": "user-example",
"name": "资料整理团队",
"status": "active",
"version": 1,
"membership_version": 2,
"created_at": "2026-11-12T01:00:00Z",
"updated_at": "2026-11-12T01:00:00Z",
"description": "整理与核对资料"
}
],
"total": 1,
"limit": 50,
"offset": 0
}
}
Field |
Type |
Description |
|---|---|---|
|
integer |
0 on success. |
|
object |
HTTP 200. Returns the corresponding object; confirm writes with the corresponding read operation.
Error response¶
Errors and concurrency handling distinguishes parameter, version, member/conversation state, and admission failures.