Get a team

Returns one team by team_id, or by name (with scope), with its version history, workflow, roles, agents, readme and inputs, and what you may do with it (can_edit, can_delete, can_toggle_listing). Send version for an older version.

Requires a token whose user can see the team given by team_id or name: a public listed team, or a team of an organization you belong to. Without sign-in: listed public teams only.

POST /v1/teams/get_by_id

cURL

by_name

curl --request POST \ --url https://{host}/v1/teams/get_by_id \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "scope": "acme", "name": "code-review" } '

200

Example

{ "ok": true, "data": { "id": "3f6c2a8e-6b1d-4c1e-9a57-0d2f4b8e91c4", "name": "code-review", "scope": "acme", "description": "Reviews a pull request and posts findings.", "license": "MIT", "visibility": "public", "status": "published", "author": "sshah", "latest_version": "1.5.0", "install_count": 128, "tags": [ "review" ], "versions": [ { "version": "1.5.0", "changelog": "Adds a fix phase", "published_at": 1759833600000, "is_latest": true } ], "workflow": { "phases": [ { "name": "review", "agent": "claude-code" } ] }, "roles": [ { "name": "review", "content_md": "# Reviewer" } ], "agents": {}, "readme": "", "cliq_version": null, "tools": [ "git" ], "listed": true, "raw_manifest": "name: code-review\nversion: 1.5.0\n…", "forked_from": null, "fork_count": 0, "draft": null, "can_edit": true, "can_delete": true, "can_toggle_listing": true } }

Authorizations

Authorization · string · header · required

User PAT (cliq_tok_…, including session-scoped) or realm token (cliq_dt_…).

Body

application/json

name · string

Team name — mutually exclusive with team_id

scope · string

Scope (publisher) slug; required when name is provided and scope is ambiguous

team_id · string<uuid>

Team UUID — mutually exclusive with name

version · string

Pin to a specific published version; omit for latest

Response

200

application/json

Success.

ok · enum<boolean> · required

Always true on success.

Available options: true

data · object · required

One team with its latest (or requested) version.

Show child attributes