Teams

Rename a team

curl -X PATCH https://api.subscriby.net/v1/teams/$TEAM_ID \
  -H "Authorization: Bearer $SUBSCRIBY_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"name": "Research Collective (EU)"}'

name is the only mutable field. Ownership does not transfer through this endpoint, and membership moves through its own routes. Owner only. Answers 200 with the team and emits team.updated.

patch/v1/teams/{team}

Request

  • Base URL: https://api.subscriby.net
  • URL: https://api.subscriby.net/v1/teams/{team}
  • Auth: HTTP bearer

Path parameters

teamstring uuid required

The team, resolved by the route binder.

Headers

Idempotency-Keystring uuid required

A key unique to this operation, such as a fresh UUID. The same key replays the original 2xx response for 24 hours (with Idempotent-Replay: true), so a retry after a timeout never repeats the write; the same key with a different body is refused with 409.

Request body

namestring required

The team's name, up to 255 characters; the only mutable field.

Response

The team after the change.

Example response

{
  "data": {
    "id": "a83f0d51-4c92-4b7e-8615-2fd9e70a3c86",
    "name": "Research Collective",
    "owner_user_id": "2a91c4e7-6f38-4b52-8e0d-9c1a7b3f5d80",
    "created_at": "2026-01-12T10:05:00Z"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.