List teams (paginated; optional ancestor filter)

GET

/teams

• Local development behind nginx (port 8088 by default)

Returns every team the caller can see, ordered by name. When ancestor is supplied, returns only that team and every team in its closure (descendants), which lets the upload modal scope a picker to “teams under Aurora R&D” without N+1. Requires teams.read.

Authorizations

• cookieAuth
• bearerAuth

Parameters

Query Parameters

ancestor

string format: uuid

limit

integer

default: 100 >= 1 <= 500

cursor

string

Responses

200

A page of teams

object

items

required

Array<object>

object

id

required

string format: uuid

slug

required

URL-friendly identifier, unique per origin server. Used in display and (eventually) federation actor URIs.

string

<= 80 characters

Example

aurora-rnd

name

required

string

<= 200 characters

Example

Aurora R&D

description

required

string

<= 500 characters

origin_server_id

Set on rows mirroring a federated team. NULL = locally owned.

string format: uuid

nullable

parents

Direct parent teams (single hop). Empty for root teams. Closure-walked ancestors live behind the listTeams ancestor filter; this field is just the edges out of the current node.

Array<object>

object

parent_id

required

string format: uuid

parent_slug

string

parent_name

string

created_at

required

string format: date-time

updated_at

required

string format: date-time

next_cursor

string

nullable

401

Authentication required, missing, or invalid

object

error

required

Human-readable error summary

string

Example

the request could not be completed

Example

{
  "error": "authentication required: sign in and retry with a valid session or API token"
}

403

Authenticated but missing required capabilities

object

error

required

Human-readable error summary

string

Example

the request could not be completed

500

Unexpected server error

object

error

required

Human-readable error summary

string

Example

the request could not be completed