Skip to main content
GET
cURL
Use a team’s id as the team_id on endpoints that take one, such as List agents.The personal workspace is not a team and is not listed. Agents owned personally carry the owner’s own user ID as their team_id, and an unscoped List agents call returns them.Authenticate with OAuth (orchestrivo_api scope, or orchestrivo_api.teams alone) or a personal API key and user ID. A team API key must send its own team as team_id in the query string and receives that one team. In Python use client.teams.list(); in the terminal use orchestrivo teams list --json.

Authorizations

Authorization
string
header
required

A personal API key or an OAuth 2.0 access token. Personal API keys also require the x-auth-key header with your user ID.

Query Parameters

team_id
string

Team scope when using a team API key. Required with a team key and must be the key's own team; ignored with OAuth or a personal API key.

Response

Every team the caller belongs to. Empty when they belong to none.

teams
object[]
required

The whole list, unpaginated. A team carries id and name only.