Rename or re-describe a team

PATCH

/teams/{id}

• Local development behind nginx (port 8088 by default)

Patches name and/or description. Re-parenting goes through the dedicated /teams/{id}/parents endpoints to keep the closure-maintenance triggers’ contract clear.

Authorizations

• cookieAuth
• bearerAuth

Parameters

Path Parameters

id

required

string format: uuid

Request Body ^required

object

name

string

>= 1 characters <= 200 characters

description

string

<= 500 characters

Responses

200

Updated

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

400

Malformed request

object

error

required

Human-readable error summary

string

Example

the request could not be completed

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

404

Resource not found

object

error

required

Human-readable error summary

string

Example

the request could not be completed