Teams

Create a team

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

The caller becomes the team owner. Ownership is not a membership row: the owner cannot be removed from the team, cannot be re-roled, and is the only account permitted to rename or delete it.

A new team starts empty. Add people with Team Members, and give them something to hold with Roles. Answers 201 with the team and emits team.created.

post/v1/teams

Request

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

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 new team.

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.