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

workspace_id

Path

string

Yes

Current Workspace ID, consistent with the product identity and request headers in the same environment.

query

Query

string

No

Name or description search text.

status

Query

string

No

active/deleting/deleted. Omit to skip this filter.

limit

Query

integer

No

Default 50, maximum 200. Nonpositive or invalid values use 50.

offset

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

code

integer

0 on success.

data

object

Corresponding response 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.

Last updated on