Teams

List teams

Returns the teams in your account, newest first, filtered by `status`. With organization-scoped credentials, returns only that organization's teams.

Query parameters

Responses

Request

curl 'https://api.agnt.ai/teams' \
  -H "Authorization: Bearer ak_live_..."

Response

{
  "ok": true,
  "teams": [
    {
      "id": "6660c4a1f2e3b7d8a9c01234",
      "account": "account",
      "organization": "organization",
      "name": "Ava"
    }
  ]
}

Create a team

Creates a team in the caller's organization, when there is one. Called as a user, that user is the owner; with an account key, pass `ownerId`.

Request body

Responses

Request

curl 'https://api.agnt.ai/teams' \
  -X POST \
  -H "Authorization: Bearer ak_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Ava"
}'

Response

{
  "ok": true,
  "team": {
    "id": "6660c4a1f2e3b7d8a9c01234",
    "account": "account",
    "organization": "organization",
    "name": "Ava"
  }
}

Retrieve a team

Retrieves a team.

Path parameters

Responses

Request

curl 'https://api.agnt.ai/teams/<teamId>' \
  -H "Authorization: Bearer ak_live_..."

Response

{
  "ok": true,
  "team": {
    "id": "6660c4a1f2e3b7d8a9c01234",
    "account": "account",
    "organization": "organization",
    "name": "Ava"
  }
}

Update a team

Updates a team. Only the fields you send change. Requires a team admin.

Path parameters

Request body

Responses

Request

curl 'https://api.agnt.ai/teams/<teamId>' \
  -X PUT \
  -H "Authorization: Bearer ak_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Ava",
  "generalInfo": "generalinfo",
  "adminApprovalRequired": true,
  "status": "active"
}'

Response

{
  "ok": true,
  "team": {
    "id": "6660c4a1f2e3b7d8a9c01234",
    "account": "account",
    "organization": "organization",
    "name": "Ava"
  }
}

Delete a team

Deletes a team. Its memberships are archived, and its assistants are detached from it. Requires a team admin.

Path parameters

Responses

Request

curl 'https://api.agnt.ai/teams/<teamId>' \
  -X DELETE \
  -H "Authorization: Bearer ak_live_..."

Response

{
  "ok": true,
  "team": {
    "id": "6660c4a1f2e3b7d8a9c01234"
  }
}

List team members

Returns the team's members, newest first, each with the user, role and status. Archived members appear only when you filter by `status`; `search` matches name and email.

Path parameters

Query parameters

Responses

Request

curl 'https://api.agnt.ai/teams/<teamId>/members' \
  -H "Authorization: Bearer ak_live_..."

Response

{
  "ok": true,
  "members": [
    {
      "id": "6660c4a1f2e3b7d8a9c01234",
      "user": {
        "id": "6660c4a1f2e3b7d8a9c01234",
        "account": "account",
        "assistant": "assistant",
        "name": "Ava",
        "avatarUrl": "https://example.com",
        "timezone": "America/New_York"
      },
      "role": "member",
      "status": "active"
    }
  ]
}

Add a team member

Adds a user to the team as `member` or `admin`. A user has one active team, so this moves them from their current team; if they own that team and it has other active members, pass `newOwnerId`. Requires a team admin.

Path parameters

Request body

Responses

Request

curl 'https://api.agnt.ai/teams/<teamId>/members' \
  -X POST \
  -H "Authorization: Bearer ak_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "userId": "6702b1e8f9a0b1c2d3e4f5a6"
}'

Response

{
  "ok": true,
  "member": {
    "id": "6660c4a1f2e3b7d8a9c01234",
    "user": {
      "id": "6660c4a1f2e3b7d8a9c01234",
      "account": "account",
      "assistant": "assistant",
      "name": "Ava",
      "avatarUrl": "https://example.com",
      "timezone": "America/New_York"
    },
    "role": "member",
    "status": "active"
  }
}

Update a team member

Changes a member's role or status. `memberId` is the membership id from the members list. When the owner makes someone else owner, the current owner becomes an admin.

Path parameters

Request body

Responses

Request

curl 'https://api.agnt.ai/teams/<teamId>/members/<memberId>' \
  -X PUT \
  -H "Authorization: Bearer ak_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "role": "member",
  "status": "active"
}'

Response

{
  "ok": true,
  "member": {
    "id": "6660c4a1f2e3b7d8a9c01234",
    "user": {
      "id": "6660c4a1f2e3b7d8a9c01234",
      "account": "account",
      "assistant": "assistant",
      "name": "Ava",
      "avatarUrl": "https://example.com",
      "timezone": "America/New_York"
    },
    "role": "member",
    "status": "active"
  }
}

Remove a team member

Removes a member from the team. `memberId` is the membership id from the members list. The owner cannot be removed, team admins cannot remove other admins, and you cannot remove yourself.

Path parameters

Responses

Request

curl 'https://api.agnt.ai/teams/<teamId>/members/<memberId>' \
  -X DELETE \
  -H "Authorization: Bearer ak_live_..."

Response

{
  "ok": true,
  "member": {
    "id": "6660c4a1f2e3b7d8a9c01234"
  }
}

Retrieve team policy

Returns the team's overrides (`null` inherits from the organization) and the action types the organization locked, with their pinned modes. Requires an account key or a team admin.

Path parameters

Responses

Request

curl 'https://api.agnt.ai/teams/<teamId>/settings/resource-permissions' \
  -H "Authorization: Bearer ak_live_..."

Response

{
  "ok": true,
  "settings": {
    "skills": {},
    "workflows": {},
    "assistants": {},
    "store": {}
  }
}

Update team policy

Sets team overrides; `null` inherits from the organization. A team can only tighten: overrides for action types the organization locked are ignored, and the stricter lock wins. Requires an account key or a team admin.

Path parameters

Request body

Responses

Request

curl 'https://api.agnt.ai/teams/<teamId>/settings/resource-permissions' \
  -X PATCH \
  -H "Authorization: Bearer ak_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "skills": {},
  "workflows": {},
  "assistants": {},
  "store": {
    "enabled": true,
    "allowlist": [
      "allowlist"
    ],
    "blocklist": [
      "blocklist"
    ]
  }
}'

Response

{
  "ok": true,
  "settings": {}
}

Apply the restricted preset

Turns off and locks connected tool servers, custom tool servers, the workspace shell, workspace handoff and browser automation for the team in one call. Requires an account key or a team admin.

Path parameters

Request body

Responses

Request

curl 'https://api.agnt.ai/teams/<teamId>/settings/security-preset' \
  -X POST \
  -H "Authorization: Bearer ak_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "preset": "restricted"
}'

Response

{
  "ok": true,
  "settings": {}
}

List team connections

Returns every connection available to the team (built in, from a skill, or a custom tool server) with the organization setting, the team override and the effective state, plus whether members can add custom tool servers. Requires an account key or a team admin.

Path parameters

Responses

Request

curl 'https://api.agnt.ai/teams/<teamId>/settings/connections' \
  -H "Authorization: Bearer ak_live_..."

Response

{
  "connections": [
    {
      "id": "6660c4a1f2e3b7d8a9c01234",
      "displayName": "Ava",
      "description": "Draft it, get Maria to sign off, send it.",
      "authMethod": "authmethod"
    }
  ],
  "allowCustomMcp": {
    "effective": true,
    "orgOverride": true,
    "teamOverride": true
  }
}

Update a team connection

Turns a connection on or off for the team, or clears the override to inherit the organization setting. Requires an account key or a team admin.

Path parameters

Request body

Responses

Request

curl 'https://api.agnt.ai/teams/<teamId>/settings/connections/<connectionId>' \
  -X PATCH \
  -H "Authorization: Bearer ak_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "enabled": "inherit"
}'

Response

{
  "connectionId": "6660c4a1f2e3b7d8a9c01234",
  "teamEnabled": "inherit"
}

Update custom tool server access

Sets whether team members can add their own custom tool servers, or inherit the organization setting. A block at the organization or team level wins. Requires an account key or a team admin.

Path parameters

Request body

Responses

Request

curl 'https://api.agnt.ai/teams/<teamId>/settings/custom-mcp' \
  -X PATCH \
  -H "Authorization: Bearer ak_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "allowCustomMcp": "inherit"
}'

Response

{
  "allowCustomMcp": {
    "effective": true,
    "orgOverride": true,
    "teamOverride": true
  }
}

Transfer team ownership

Makes another active member the owner. The current owner becomes a member, and the billing contact moves to the new owner. Call it as the current owner.

Path parameters

Request body

Responses

Request

curl 'https://api.agnt.ai/teams/<teamId>/transfer-ownership' \
  -X POST \
  -H "Authorization: Bearer ak_live_..." \
  -H "X-User-Email: [email protected]" \
  -H "Content-Type: application/json" \
  -d '{
  "newOwnerId": "6660c4a1f2e3b7d8a9c01234"
}'

Response

{
  "ok": true,
  "newOwner": {
    "id": "6660c4a1f2e3b7d8a9c01234",
    "email": "[email protected]"
  }
}