Zum Hauptinhalt springen
DokumentationIdentität und Zugriff · console.eu.ccsio.ai

Teams

The teams of an organization: create, read, rename, archive and unarchive.

Menü der Dokumentation

Die Beschreibungen der Operationen und Felder stammen aus dem Vertrag und sind auf Englisch.

GET/identity/v1/organizations/{org}/teams

List the organization's teams

Anmeldedaten
API-Key
Berechtigung
Eine vonteams.read_ownteams.readsupport-access.read

Lists the organization's teams deterministic by team id. Open to teams.read_own at any level or teams.read.

Weiterlesen

WHICH teams: a caller holding teams.read at organization level (or at platform level) sees every team of the organization; any other caller sees only the teams where it has an active team-level role binding (a User or a Team Admin whose only role is a team's sees its own teams). include_archived=true includes archived teams for the first kind of caller; a binding in an archived team authorizes nothing, so the second kind never sees one. Each item is a TeamDetail (the create response's fields plus slug, status and updated_at) and carries member_count, the number of distinct principals with an active team-level role binding in the team, read with the list in one statement.

curl
curl "https://console.eu.ccsio.ai/identity/v1/organizations/{org}/teams" \
  -H "Authorization: Bearer $CCSIO_API_KEY"

Parameter

NameInBeschreibung
X-Request-ID
optional
headerstring

Optional request ULID. A valid ULID (upper or lowercase) is honored; when the header is absent or invalid, the runtime mints the id. The response X-Request-ID header carries the canonical uppercase form.

org
Pflicht
pathstring

The organization id (C7 identifier). A value outside the pattern is refused with 400 name-invalid.

include_archived
optional
querystring

Optional. true includes archived teams in the list; any other value, or leaving the parameter out, leaves them out (no value is refused).

Antworten

  • 200

    The team list (TeamDetail items).

    Schema
    ListTeamsResponseDetail
    • teamsarray of TeamDetailPflicht
      • org_idstringPflicht

        pattern ^[a-z][a-z0-9._-]{0,63}$

      • team_idstringPflicht

        pattern ^[a-z][a-z0-9._-]{0,63}$

      • namestringPflicht

        1 to 128 characters

      • slugstringPflicht

        Organization-scoped unique; defaults to team_id at creation.

        pattern ^[a-z][a-z0-9._-]{0,63}$

      • statusstringPflicht

        Erlaubte Werte: "active""archived"

      • member_countintegerPflicht

        The number of distinct principals holding an active team-level role binding in the team.

        at least 0

      • created_atstring (date-time)Pflicht

        RFC 3339, second precision, UTC.

      • updated_atstring (date-time)Pflicht

        RFC 3339, second precision, UTC.

  • 400

    Client refusal unrelated to authentication, including malformed input, a denied or failed request.

  • 401

    The request carries no credential, more than one, or one the platform does not accept, and is refused before the operation runs; `error.code` says why. Supply exactly one credential. Codes: invalid-request (no credential, or both Authorization:

    Weiterlesen

    Bearer and x-api-key), api-key-invalid (a value that is not a platform API key, or a key of a kind the platform does not accept), api-key-unknown, api-key-revoked, api-key-expired, bootstrap-disabled (the one-shot installation credential, once a key exists), token-malformed (a bearer token that is not a JWT), token-algorithm-unsupported, token-signature-invalid, token-claim-invalid, token-issuer-mismatch, token-audience-mismatch, token-expired, token-not-yet-valid, issuer-untrusted, issuer-residency-mismatch (the issuer belongs to another plane), issuer-resolution-unknown, jwks-unavailable, jwks-key-not-found, staff-token-inactive (a platform operator's token), staff-not-operator, staff-directory-unavailable, identity-not-provisioned (a verified identity with no account on this plane), organization-not-found (a verified identity or key whose organization this plane does not know), internal-error (a fault while the credential is checked is refused too, fail closed), context-cancelled

  • 402

    The organization has to pay first: its standing is payment_required.

    Weiterlesen

    The request boundary applies this payment gate to every route except an organization's billing routes, the caller's own context, organization list, onboarding, session report and personal keys, the public routes, and the routes of platform operators, who administer an organization that has to pay. The operations the gate covers declare this response. On /v1 the refusal is rendered in the OpenAI error format. Code: payment-required

  • 403

    No role of the caller holds any of `teams.read_own`, `teams.read` or `support-access.read` in the organization, at organization or team level (policy-denied), or the organization the request names is not the caller's own (tenant-mismatch). Codes: policy-denied, tenant-mismatch

  • 404

    The requested resource or path was not found.

  • 405

    The path is claimed but the request method is not allowed. Go ServeMux returns its standard plain-text response and lists permitted methods in Allow.

  • 500

    Platform failure, rendered without internal cause details.

  • 503

    An operator's read under an open support session could not be recorded, so nothing was served. Codes: support-audit-unavailable

POST/identity/v1/organizations/{org}/teams

Create a team in the organization

Anmeldedaten
API-Key
Berechtigung
teams.create
Request-Body
Body bis 1 MiB

team_id and name are both required. Idempotency: a duplicate (org, team) carrying the same name returns the stored team (200); a different name is 400 team-conflict.

curl
curl -X POST "https://console.eu.ccsio.ai/identity/v1/organizations/{org}/teams" \
  -H "Authorization: Bearer $CCSIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "team_id": "platform",
  "name": "Platform"
}'

Parameter

NameInBeschreibung
X-Request-ID
optional
headerstring

Optional request ULID. A valid ULID (upper or lowercase) is honored; when the header is absent or invalid, the runtime mints the id. The response X-Request-ID header carries the canonical uppercase form.

org
Pflicht
pathstring

The organization id (C7 identifier). A value outside the pattern is refused with 400 name-invalid.

Request-Body application/json

CreateTeamRequest
  • team_idstringPflicht

    The team id (C7 identifier).

    pattern ^[a-z][a-z0-9._-]{0,63}$

  • namestringPflicht

    The team name.

    1 to 128 characters

Antworten

  • 200

    The team view.

    Schema
    Team
    • org_idstringPflicht

      pattern ^[a-z][a-z0-9._-]{0,63}$

    • team_idstringPflicht

      pattern ^[a-z][a-z0-9._-]{0,63}$

    • namestringPflicht

      1 to 128 characters

    • created_atstring (date-time)Pflicht

      RFC 3339, second precision, UTC.

  • 400

    Client refusal. Codes: invalid-request (the body is not valid JSON, has an unknown or trailing member, or lacks a required one), name-invalid (team_id outside the C7 pattern), organization-invalid (the team name is empty or longer than 128 bytes), team-conflict (team_id is taken by a team with another name)

  • 401

    The request carries no credential, more than one, or one the platform does not accept, and is refused before the operation runs; `error.code` says why. Supply exactly one credential. Codes: invalid-request (no credential, or both Authorization:

    Weiterlesen

    Bearer and x-api-key), api-key-invalid (a value that is not a platform API key, or a key of a kind the platform does not accept), api-key-unknown, api-key-revoked, api-key-expired, bootstrap-disabled (the one-shot installation credential, once a key exists), token-malformed (a bearer token that is not a JWT), token-algorithm-unsupported, token-signature-invalid, token-claim-invalid, token-issuer-mismatch, token-audience-mismatch, token-expired, token-not-yet-valid, issuer-untrusted, issuer-residency-mismatch (the issuer belongs to another plane), issuer-resolution-unknown, jwks-unavailable, jwks-key-not-found, staff-token-inactive (a platform operator's token), staff-not-operator, staff-directory-unavailable, identity-not-provisioned (a verified identity with no account on this plane), organization-not-found (a verified identity or key whose organization this plane does not know), internal-error (a fault while the credential is checked is refused too, fail closed), context-cancelled

  • 402

    The organization has to pay first: its standing is payment_required.

    Weiterlesen

    The request boundary applies this payment gate to every route except an organization's billing routes, the caller's own context, organization list, onboarding, session report and personal keys, the public routes, and the routes of platform operators, who administer an organization that has to pay. The operations the gate covers declare this response. On /v1 the refusal is rendered in the OpenAI error format. Code: payment-required

  • 403

    No role of the caller holds `teams.create` in the organization (policy-denied), or the organization the request names is not the caller's own (tenant-mismatch). Codes: policy-denied, tenant-mismatch

  • 404

    The organization was deleted while the request ran. Codes: organization-not-found

  • 405

    The path is claimed but the request method is not allowed. Go ServeMux returns its standard plain-text response and lists permitted methods in Allow.

  • 500

    Platform failure, rendered without internal cause details.

Beispielantwort
{
  "org_id": "acme",
  "team_id": "platform",
  "name": "Platform",
  "created_at": "2026-10-14T09:12:00Z"
}
GET/identity/v1/organizations/{org}/teams/{team}

Read one team

Anmeldedaten
API-Key
Berechtigung
Eine vonteams.readsupport-access.read

Returns one team of the organization with its member_count (the number of distinct principals holding an active team-level role binding in it). An unknown organization or team is 404 team-not-found: the lookup cannot tell them apart.

curl
curl "https://console.eu.ccsio.ai/identity/v1/organizations/{org}/teams/{team}" \
  -H "Authorization: Bearer $CCSIO_API_KEY"

Parameter

NameInBeschreibung
X-Request-ID
optional
headerstring

Optional request ULID. A valid ULID (upper or lowercase) is honored; when the header is absent or invalid, the runtime mints the id. The response X-Request-ID header carries the canonical uppercase form.

org
Pflicht
pathstring

The organization id (C7 identifier). A value outside the pattern is refused with 400 name-invalid.

team
Pflicht
pathstring

The team id (C7 identifier). A value outside the pattern is refused with 400 name-invalid.

Antworten

  • 200

    The team detail view.

    Schema
    TeamDetail
    • org_idstringPflicht

      pattern ^[a-z][a-z0-9._-]{0,63}$

    • team_idstringPflicht

      pattern ^[a-z][a-z0-9._-]{0,63}$

    • namestringPflicht

      1 to 128 characters

    • slugstringPflicht

      Organization-scoped unique; defaults to team_id at creation.

      pattern ^[a-z][a-z0-9._-]{0,63}$

    • statusstringPflicht

      Erlaubte Werte: "active""archived"

    • member_countintegerPflicht

      The number of distinct principals holding an active team-level role binding in the team.

      at least 0

    • created_atstring (date-time)Pflicht

      RFC 3339, second precision, UTC.

    • updated_atstring (date-time)Pflicht

      RFC 3339, second precision, UTC.

  • 400

    Client refusal. Codes: name-invalid (team in the path outside the C7 pattern)

  • 401

    The request carries no credential, more than one, or one the platform does not accept, and is refused before the operation runs; `error.code` says why. Supply exactly one credential. Codes: invalid-request (no credential, or both Authorization:

    Weiterlesen

    Bearer and x-api-key), api-key-invalid (a value that is not a platform API key, or a key of a kind the platform does not accept), api-key-unknown, api-key-revoked, api-key-expired, bootstrap-disabled (the one-shot installation credential, once a key exists), token-malformed (a bearer token that is not a JWT), token-algorithm-unsupported, token-signature-invalid, token-claim-invalid, token-issuer-mismatch, token-audience-mismatch, token-expired, token-not-yet-valid, issuer-untrusted, issuer-residency-mismatch (the issuer belongs to another plane), issuer-resolution-unknown, jwks-unavailable, jwks-key-not-found, staff-token-inactive (a platform operator's token), staff-not-operator, staff-directory-unavailable, identity-not-provisioned (a verified identity with no account on this plane), organization-not-found (a verified identity or key whose organization this plane does not know), internal-error (a fault while the credential is checked is refused too, fail closed), context-cancelled

  • 402

    The organization has to pay first: its standing is payment_required.

    Weiterlesen

    The request boundary applies this payment gate to every route except an organization's billing routes, the caller's own context, organization list, onboarding, session report and personal keys, the public routes, and the routes of platform operators, who administer an organization that has to pay. The operations the gate covers declare this response. On /v1 the refusal is rendered in the OpenAI error format. Code: payment-required

  • 403

    No role of the caller holds either `teams.read` or `support-access.read` for the team the path names or at organization level (policy-denied), or the organization the request names is not the caller's own (tenant-mismatch). Codes: policy-denied, tenant-mismatch

  • 404

    The team does not exist in the organization. Codes: team-not-found

  • 405

    The path is claimed but the request method is not allowed. Go ServeMux returns its standard plain-text response and lists permitted methods in Allow.

  • 500

    Platform failure, rendered without internal cause details.

  • 503

    An operator's read under an open support session could not be recorded, so nothing was served. Codes: support-audit-unavailable

PATCH/identity/v1/organizations/{org}/teams/{team}

Rename a team

Anmeldedaten
API-Key
Berechtigung
teams.update
Request-Body
Body bis 1 MiB

Renames the team. name is required and non-empty (1 to 128 bytes of UTF-8).

curl
curl -X PATCH "https://console.eu.ccsio.ai/identity/v1/organizations/{org}/teams/{team}" \
  -H "Authorization: Bearer $CCSIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string"
}'
Aus den Pflichtfeldern des Schemas erzeugt: ersetze die Werte.

Parameter

NameInBeschreibung
X-Request-ID
optional
headerstring

Optional request ULID. A valid ULID (upper or lowercase) is honored; when the header is absent or invalid, the runtime mints the id. The response X-Request-ID header carries the canonical uppercase form.

org
Pflicht
pathstring

The organization id (C7 identifier). A value outside the pattern is refused with 400 name-invalid.

team
Pflicht
pathstring

The team id (C7 identifier). A value outside the pattern is refused with 400 name-invalid.

Request-Body application/json

PatchTeamRequest
  • namestringPflicht

    The new team name, 1 to 128 bytes of UTF-8 (a multi-byte character counts for each of its bytes).

    1 to 128 characters

Antworten

  • 200

    The updated team detail view.

    Schema
    TeamDetail
    • org_idstringPflicht

      pattern ^[a-z][a-z0-9._-]{0,63}$

    • team_idstringPflicht

      pattern ^[a-z][a-z0-9._-]{0,63}$

    • namestringPflicht

      1 to 128 characters

    • slugstringPflicht

      Organization-scoped unique; defaults to team_id at creation.

      pattern ^[a-z][a-z0-9._-]{0,63}$

    • statusstringPflicht

      Erlaubte Werte: "active""archived"

    • member_countintegerPflicht

      The number of distinct principals holding an active team-level role binding in the team.

      at least 0

    • created_atstring (date-time)Pflicht

      RFC 3339, second precision, UTC.

    • updated_atstring (date-time)Pflicht

      RFC 3339, second precision, UTC.

  • 400

    Client refusal. Codes: invalid-request (the body is not valid JSON, has an unknown or trailing member, or lacks a required one), name-invalid (team in the path outside the C7 pattern), organization-invalid (the new name is empty or longer than 128 bytes)

  • 401

    The request carries no credential, more than one, or one the platform does not accept, and is refused before the operation runs; `error.code` says why. Supply exactly one credential. Codes: invalid-request (no credential, or both Authorization:

    Weiterlesen

    Bearer and x-api-key), api-key-invalid (a value that is not a platform API key, or a key of a kind the platform does not accept), api-key-unknown, api-key-revoked, api-key-expired, bootstrap-disabled (the one-shot installation credential, once a key exists), token-malformed (a bearer token that is not a JWT), token-algorithm-unsupported, token-signature-invalid, token-claim-invalid, token-issuer-mismatch, token-audience-mismatch, token-expired, token-not-yet-valid, issuer-untrusted, issuer-residency-mismatch (the issuer belongs to another plane), issuer-resolution-unknown, jwks-unavailable, jwks-key-not-found, staff-token-inactive (a platform operator's token), staff-not-operator, staff-directory-unavailable, identity-not-provisioned (a verified identity with no account on this plane), organization-not-found (a verified identity or key whose organization this plane does not know), internal-error (a fault while the credential is checked is refused too, fail closed), context-cancelled

  • 402

    The organization has to pay first: its standing is payment_required.

    Weiterlesen

    The request boundary applies this payment gate to every route except an organization's billing routes, the caller's own context, organization list, onboarding, session report and personal keys, the public routes, and the routes of platform operators, who administer an organization that has to pay. The operations the gate covers declare this response. On /v1 the refusal is rendered in the OpenAI error format. Code: payment-required

  • 403

    No role of the caller holds `teams.update` for the team the path names or at organization level (policy-denied), or the organization the request names is not the caller's own (tenant-mismatch). Codes: policy-denied, tenant-mismatch

  • 404

    The team does not exist in the organization. Codes: team-not-found

  • 405

    The path is claimed but the request method is not allowed. Go ServeMux returns its standard plain-text response and lists permitted methods in Allow.

  • 500

    Platform failure, rendered without internal cause details.

POST/identity/v1/organizations/{org}/teams/{team}/archive

Archive a team

Anmeldedaten
API-Key
Berechtigung
teams.archive

Idempotent: archiving an already-archived team returns it unchanged. An archived team takes no new members (adding one, or reading the member candidates, answers 409 team-archived) and is left out of the default team list (include_archived=true brings it back).

curl
curl -X POST "https://console.eu.ccsio.ai/identity/v1/organizations/{org}/teams/{team}/archive" \
  -H "Authorization: Bearer $CCSIO_API_KEY"

Parameter

NameInBeschreibung
X-Request-ID
optional
headerstring

Optional request ULID. A valid ULID (upper or lowercase) is honored; when the header is absent or invalid, the runtime mints the id. The response X-Request-ID header carries the canonical uppercase form.

org
Pflicht
pathstring

The organization id (C7 identifier). A value outside the pattern is refused with 400 name-invalid.

team
Pflicht
pathstring

The team id (C7 identifier). A value outside the pattern is refused with 400 name-invalid.

Antworten

  • 200

    The team detail view, status archived.

    Schema
    TeamDetail
    • org_idstringPflicht

      pattern ^[a-z][a-z0-9._-]{0,63}$

    • team_idstringPflicht

      pattern ^[a-z][a-z0-9._-]{0,63}$

    • namestringPflicht

      1 to 128 characters

    • slugstringPflicht

      Organization-scoped unique; defaults to team_id at creation.

      pattern ^[a-z][a-z0-9._-]{0,63}$

    • statusstringPflicht

      Erlaubte Werte: "active""archived"

    • member_countintegerPflicht

      The number of distinct principals holding an active team-level role binding in the team.

      at least 0

    • created_atstring (date-time)Pflicht

      RFC 3339, second precision, UTC.

    • updated_atstring (date-time)Pflicht

      RFC 3339, second precision, UTC.

  • 400

    Client refusal. Codes: name-invalid (team in the path outside the C7 pattern)

  • 401

    The request carries no credential, more than one, or one the platform does not accept, and is refused before the operation runs; `error.code` says why. Supply exactly one credential. Codes: invalid-request (no credential, or both Authorization:

    Weiterlesen

    Bearer and x-api-key), api-key-invalid (a value that is not a platform API key, or a key of a kind the platform does not accept), api-key-unknown, api-key-revoked, api-key-expired, bootstrap-disabled (the one-shot installation credential, once a key exists), token-malformed (a bearer token that is not a JWT), token-algorithm-unsupported, token-signature-invalid, token-claim-invalid, token-issuer-mismatch, token-audience-mismatch, token-expired, token-not-yet-valid, issuer-untrusted, issuer-residency-mismatch (the issuer belongs to another plane), issuer-resolution-unknown, jwks-unavailable, jwks-key-not-found, staff-token-inactive (a platform operator's token), staff-not-operator, staff-directory-unavailable, identity-not-provisioned (a verified identity with no account on this plane), organization-not-found (a verified identity or key whose organization this plane does not know), internal-error (a fault while the credential is checked is refused too, fail closed), context-cancelled

  • 402

    The organization has to pay first: its standing is payment_required.

    Weiterlesen

    The request boundary applies this payment gate to every route except an organization's billing routes, the caller's own context, organization list, onboarding, session report and personal keys, the public routes, and the routes of platform operators, who administer an organization that has to pay. The operations the gate covers declare this response. On /v1 the refusal is rendered in the OpenAI error format. Code: payment-required

  • 403

    No role of the caller holds `teams.archive` for the team the path names or at organization level (policy-denied), or the organization the request names is not the caller's own (tenant-mismatch). Codes: policy-denied, tenant-mismatch

  • 404

    The team does not exist in the organization. Codes: team-not-found

  • 405

    The path is claimed but the request method is not allowed. Go ServeMux returns its standard plain-text response and lists permitted methods in Allow.

  • 500

    Platform failure, rendered without internal cause details.

POST/identity/v1/organizations/{org}/teams/{team}/unarchive

Unarchive a team

Anmeldedaten
API-Key
Berechtigung
teams.archive

Idempotent, symmetric with archive.

curl
curl -X POST "https://console.eu.ccsio.ai/identity/v1/organizations/{org}/teams/{team}/unarchive" \
  -H "Authorization: Bearer $CCSIO_API_KEY"

Parameter

NameInBeschreibung
X-Request-ID
optional
headerstring

Optional request ULID. A valid ULID (upper or lowercase) is honored; when the header is absent or invalid, the runtime mints the id. The response X-Request-ID header carries the canonical uppercase form.

org
Pflicht
pathstring

The organization id (C7 identifier). A value outside the pattern is refused with 400 name-invalid.

team
Pflicht
pathstring

The team id (C7 identifier). A value outside the pattern is refused with 400 name-invalid.

Antworten

  • 200

    The team detail view, status active.

    Schema
    TeamDetail
    • org_idstringPflicht

      pattern ^[a-z][a-z0-9._-]{0,63}$

    • team_idstringPflicht

      pattern ^[a-z][a-z0-9._-]{0,63}$

    • namestringPflicht

      1 to 128 characters

    • slugstringPflicht

      Organization-scoped unique; defaults to team_id at creation.

      pattern ^[a-z][a-z0-9._-]{0,63}$

    • statusstringPflicht

      Erlaubte Werte: "active""archived"

    • member_countintegerPflicht

      The number of distinct principals holding an active team-level role binding in the team.

      at least 0

    • created_atstring (date-time)Pflicht

      RFC 3339, second precision, UTC.

    • updated_atstring (date-time)Pflicht

      RFC 3339, second precision, UTC.

  • 400

    Client refusal. Codes: name-invalid (team in the path outside the C7 pattern)

  • 401

    The request carries no credential, more than one, or one the platform does not accept, and is refused before the operation runs; `error.code` says why. Supply exactly one credential. Codes: invalid-request (no credential, or both Authorization:

    Weiterlesen

    Bearer and x-api-key), api-key-invalid (a value that is not a platform API key, or a key of a kind the platform does not accept), api-key-unknown, api-key-revoked, api-key-expired, bootstrap-disabled (the one-shot installation credential, once a key exists), token-malformed (a bearer token that is not a JWT), token-algorithm-unsupported, token-signature-invalid, token-claim-invalid, token-issuer-mismatch, token-audience-mismatch, token-expired, token-not-yet-valid, issuer-untrusted, issuer-residency-mismatch (the issuer belongs to another plane), issuer-resolution-unknown, jwks-unavailable, jwks-key-not-found, staff-token-inactive (a platform operator's token), staff-not-operator, staff-directory-unavailable, identity-not-provisioned (a verified identity with no account on this plane), organization-not-found (a verified identity or key whose organization this plane does not know), internal-error (a fault while the credential is checked is refused too, fail closed), context-cancelled

  • 402

    The organization has to pay first: its standing is payment_required.

    Weiterlesen

    The request boundary applies this payment gate to every route except an organization's billing routes, the caller's own context, organization list, onboarding, session report and personal keys, the public routes, and the routes of platform operators, who administer an organization that has to pay. The operations the gate covers declare this response. On /v1 the refusal is rendered in the OpenAI error format. Code: payment-required

  • 403

    No role of the caller holds `teams.archive` for the team the path names or at organization level (policy-denied), or the organization the request names is not the caller's own (tenant-mismatch). Codes: policy-denied, tenant-mismatch

  • 404

    The team does not exist in the organization. Codes: team-not-found

  • 405

    The path is claimed but the request method is not allowed. Go ServeMux returns its standard plain-text response and lists permitted methods in Allow.

  • 500

    Platform failure, rendered without internal cause details.

Erzeugt aus den Plattformverträgen beim Commit 5954fbc1.

Plattform entdecken

Deinen ersten API-Key holen

Die Registrierung ist offen. Vier Schritte bis zum ersten Aufruf: Konto erstellen, Organisation anlegen, API-Key erzeugen, loslegen.

  1. 01Konto erstellen
  2. 02Organisation anlegen
  3. 03API-Key erzeugen
  4. 04Loslegen