Saltar al contenido principal
DocumentaciónIdentidad y acceso · console.latam.ccsio.ai

Team members

A team's roster: add, read, change the role of and remove members, and the people who could be added.

Menú de la documentación

Las descripciones de las operaciones y los campos son las del contrato, en inglés.

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

List the team roster

Credencial
API key
Permiso
Cualquiera deteam-members.readsupport-access.read

Lists the team's role bindings deterministic by member ref, each with the role the member really holds (the built-in team_admin and user, or a custom role id) and the binding's status; no stored role is left out. status selects active (the default), disabled or removed bindings.

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

Parámetros

NombreEnDescripción
X-Request-ID
opcional
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
obligatorio
pathstring

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

team
obligatorio
pathstring

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

status
opcional
querystring

The membership status filter: active (default), disabled or removed. Any other value is refused with 400 invalid-request.

Respuestas

  • 200

    The team roster (role bindings).

    Esquema
    ListRoleBindingsResponse
    • membersarray of RoleBindingobligatorio
      • emailstringopcional

        Provider profile email when known; never an authorization identifier.

      • display_namestringopcional

        Readable human or service account name when known.

      • kindstringopcional

        Valores permitidos: "human""service_account"

      • organization_idstringobligatorio

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

      • team_idstring or nullobligatorio

        null for an organization-level binding.

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

      • user_refstringobligatorio

        pattern ^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$

      • rolestringobligatorio

        The binding's role: a built-in role id or the id of one of the organization's custom roles.

        pattern ^(ccsio_admin|root|organization_admin|team_admin|user|role_[a-z0-9_]{1,59})$

      • statusstringobligatorio

        Valores permitidos: "active""disabled""removed"

      • created_atstring (date-time)obligatorio

        RFC 3339, second precision, UTC.

      • updated_atstring (date-time)obligatorio

        RFC 3339, second precision, UTC.

  • 400

    Client refusal. Codes: name-invalid (team in the path outside the C7 pattern), invalid-request (status outside active, disabled and removed)

  • 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:

    Leer más

    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.

    Leer más

    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 `team-members.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

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

Add (or re-add) a member to the team

Credencial
API key
Permiso
team-members.manage
Cuerpo de la solicitud
Cuerpo de hasta 1 MiB

member_ref and role are both required; confirm_extra_seat is optional (default false). role is the team-assignable vocabulary: the built-in team_admin and user, or the id of one of the organization's custom roles (role_<id>); the legacy values admin and member are still accepted here and mean team_admin and user.

Leer más

Upsert: adding an active member returns the stored role binding with its stored role (the upsert never rewrites a stored role); adding a removed or disabled member re-activates the row, again keeping the stored role. Escalation: the acting principal (the verified caller, never a request field) must be able to manage team members over this team (an organization root or organization_admin for any team of the organization, this team's own team_admin, a platform ccsio_admin, or a holder of a custom role carrying team-members.manage) and able to grant the role being written and, on a re-add, the role the row already holds; otherwise 403 membership-forbidden. An archived team takes no new members (409 team-archived). Seats: adding a human who has no access to the organization yet takes one seat. When the seats the plan includes are all used, a self-service organization with a running subscription must confirm the extra seat with confirm_extra_seat true (409 seat-confirmation-required otherwise, nothing changes); any other organization is refused (409 seat-limit-reached). Adding someone who already has access asks nothing; a service account takes a service account slot instead of a seat (409 service-account-limit-reached when none is left).

curl
curl -X POST "https://console.latam.ccsio.ai/identity/v1/organizations/{org}/teams/{team}/members" \
  -H "Authorization: Bearer $CCSIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "member_ref": "user/onboard/01K7YN2C4D6F8H1K3M5P7R9T0V",
  "role": "user"
}'

Parámetros

NombreEnDescripción
X-Request-ID
opcional
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
obligatorio
pathstring

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

team
obligatorio
pathstring

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

Cuerpo de la solicitud application/json

AddTeamRoleBindingRequest
  • member_refstringobligatorio

    The member's C0 ref.

    pattern ^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$

  • rolestringobligatorio

    A built-in role id or a custom role id (role_<id>); only the team-level subset (team_admin, user and custom roles) is ever legal on THIS operation. The legacy values admin and member are still accepted here, and mean team_admin and user (the role change takes neither).

    pattern ^(admin|member|ccsio_admin|root|organization_admin|team_admin|user|role_[a-z0-9_]{1,59})$

  • confirm_extra_seatbooleanopcional

    Optional (default false): confirms the extra charge when adding this member needs one more seat than the plan includes (409 seat-confirmation-required without it).

Respuestas

  • 200

    The team role binding (status active; the stored role is authoritative on a re-add).

    Esquema
    RoleBinding
    • emailstringopcional

      Provider profile email when known; never an authorization identifier.

    • display_namestringopcional

      Readable human or service account name when known.

    • kindstringopcional

      Valores permitidos: "human""service_account"

    • organization_idstringobligatorio

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

    • team_idstring or nullobligatorio

      null for an organization-level binding.

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

    • user_refstringobligatorio

      pattern ^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$

    • rolestringobligatorio

      The binding's role: a built-in role id or the id of one of the organization's custom roles.

      pattern ^(ccsio_admin|root|organization_admin|team_admin|user|role_[a-z0-9_]{1,59})$

    • statusstringobligatorio

      Valores permitidos: "active""disabled""removed"

    • created_atstring (date-time)obligatorio

      RFC 3339, second precision, UTC.

    • updated_atstring (date-time)obligatorio

      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), ref-invalid (member_ref outside the C0 ref pattern), role-invalid (neither a built-in role nor one of the organization's custom roles), role-binding-invalid (a role that cannot be held at team level)

  • 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:

    Leer más

    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.

    Leer más

    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 `team-members.manage` 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, membership-forbidden (the caller cannot manage this team's members, or cannot grant the role or the member's stored role)

  • 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.

  • 409

    An archived team takes no new members, and the seat rules refuse an addition that needs a seat the organization does not have. Codes: team-archived, seat-confirmation-required, seat-limit-reached, service-account-limit-reached

  • 500

    Platform failure, rendered without internal cause details.

Respuesta de ejemplo
{
  "organization_id": "acme",
  "team_id": "platform",
  "user_ref": "user/onboard/01K7YN2C4D6F8H1K3M5P7R9T0V",
  "role": "user",
  "status": "active",
  "created_at": "2026-10-14T09:40:00Z",
  "updated_at": "2026-10-14T09:40:00Z",
  "email": "ben@example.com",
  "display_name": "Ben Okafor",
  "kind": "human"
}
PATCH/identity/v1/organizations/{org}/teams/{team}/members

Change a team member's role

Credencial
API key
Permiso
team-members.manage
Cuerpo de la solicitud
Cuerpo de hasta 1 MiB

member_ref and role are required. role is the team-assignable vocabulary: the built-in team_admin and user, or the id of one of the organization's custom roles (role_<id>).

Leer más

Unlike the add on this same path it takes neither the legacy aliases admin and member (400 role-invalid) nor confirm_extra_seat (changing a role never needs a seat). Escalation: the acting principal (the verified caller, never a request field) must be able to manage team members over this team (an organization root or organization_admin for any team of the organization, this team's own team_admin, a platform ccsio_admin, or a holder of a custom role carrying team-members.manage) and able to grant both the new role and the member's current role: a built-in administrator outranks or equals a built-in role, and any role's permissions must be a subset of the actor's own at this scope; a custom-role holder can never grant root, organization_admin or team_admin. The request is otherwise 403 membership-forbidden.

curl
curl -X PATCH "https://console.latam.ccsio.ai/identity/v1/organizations/{org}/teams/{team}/members" \
  -H "Authorization: Bearer $CCSIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "member_ref": "string",
  "role": "string"
}'
Construido con los campos obligatorios del esquema: reemplaza los valores.

Parámetros

NombreEnDescripción
X-Request-ID
opcional
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
obligatorio
pathstring

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

team
obligatorio
pathstring

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

Cuerpo de la solicitud application/json

TeamRoleBindingRequest
  • member_refstringobligatorio

    pattern ^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$

  • rolestringobligatorio

    A built-in role id or a custom role id (role_<id>); only the team-level subset (team_admin, user and custom roles) is ever legal on THIS operation. The legacy values admin and member that the add accepts are refused here (400 role-invalid).

    pattern ^(ccsio_admin|root|organization_admin|team_admin|user|role_[a-z0-9_]{1,59})$

Respuestas

  • 200

    The updated team role binding.

    Esquema
    RoleBinding
    • emailstringopcional

      Provider profile email when known; never an authorization identifier.

    • display_namestringopcional

      Readable human or service account name when known.

    • kindstringopcional

      Valores permitidos: "human""service_account"

    • organization_idstringobligatorio

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

    • team_idstring or nullobligatorio

      null for an organization-level binding.

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

    • user_refstringobligatorio

      pattern ^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$

    • rolestringobligatorio

      The binding's role: a built-in role id or the id of one of the organization's custom roles.

      pattern ^(ccsio_admin|root|organization_admin|team_admin|user|role_[a-z0-9_]{1,59})$

    • statusstringobligatorio

      Valores permitidos: "active""disabled""removed"

    • created_atstring (date-time)obligatorio

      RFC 3339, second precision, UTC.

    • updated_atstring (date-time)obligatorio

      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), ref-invalid (member_ref outside the C0 ref pattern), role-invalid (neither a built-in role nor one of the organization's custom roles), role-binding-invalid (a role that cannot be held at team level)

  • 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:

    Leer más

    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.

    Leer más

    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 `team-members.manage` 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, membership-forbidden (the caller cannot manage this team's members, or cannot grant the new role or the member's current one)

  • 404

    The member has no role binding in the team. Codes: membership-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.

DELETE/identity/v1/organizations/{org}/teams/{team}/members

Remove the member named by the query parameter

Credencial
API key
Permiso
team-members.manage

The member is named by the required member_ref query parameter, query-carried because a C0 ref may contain '/' and ':', which path segments mangle. Returns the tombstoned role binding (status removed); re-removing returns the stored tombstone (idempotent).

Leer más

Escalation: the same administrative-scope and rank rule as the add and the role change: the acting principal must be able to manage team members over this team and to grant the role the member holds, otherwise 403 membership-forbidden. A removal takes effect at once: the member's next request no longer authorizes through this team.

curl
curl -X DELETE "https://console.latam.ccsio.ai/identity/v1/organizations/{org}/teams/{team}/members?member_ref=<member_ref>" \
  -H "Authorization: Bearer $CCSIO_API_KEY"

Parámetros

NombreEnDescripción
X-Request-ID
opcional
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
obligatorio
pathstring

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

team
obligatorio
pathstring

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

member_ref
obligatorio
querystring

The member's C0 ref, query-carried because a C0 ref may contain '/' and ':' (path segments would mangle them into several tokens).

Respuestas

  • 200

    The role binding, status removed (the tombstone).

    Esquema
    RoleBinding
    • emailstringopcional

      Provider profile email when known; never an authorization identifier.

    • display_namestringopcional

      Readable human or service account name when known.

    • kindstringopcional

      Valores permitidos: "human""service_account"

    • organization_idstringobligatorio

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

    • team_idstring or nullobligatorio

      null for an organization-level binding.

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

    • user_refstringobligatorio

      pattern ^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$

    • rolestringobligatorio

      The binding's role: a built-in role id or the id of one of the organization's custom roles.

      pattern ^(ccsio_admin|root|organization_admin|team_admin|user|role_[a-z0-9_]{1,59})$

    • statusstringobligatorio

      Valores permitidos: "active""disabled""removed"

    • created_atstring (date-time)obligatorio

      RFC 3339, second precision, UTC.

    • updated_atstring (date-time)obligatorio

      RFC 3339, second precision, UTC.

  • 400

    Client refusal. Codes: invalid-request (the member_ref query parameter is missing), name-invalid (team in the path outside the C7 pattern), ref-invalid (member_ref outside the C0 ref 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:

    Leer más

    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.

    Leer más

    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 `team-members.manage` 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, membership-forbidden (the caller cannot manage this team's members, or cannot grant the member's current role)

  • 404

    The member has no role binding in the team. Codes: membership-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.

GET/identity/v1/organizations/{org}/teams/{team}/member-candidates

List eligible members for one team's member picker

Credencial
API key
Permiso
team-members.manage

Requires team-members.manage for the named team. Returns only user_ref, display_name, email and kind of the active organization-level members with an active user account, excluding the active members of this team, ordered by user_ref. Human and service_account identities are supported. Organization roles and other team affiliations are never exposed. This permission does not grant organization-wide roster access.

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

Parámetros

NombreEnDescripción
X-Request-ID
opcional
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
obligatorio
pathstring

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

team
obligatorio
pathstring

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

Respuestas

  • 200

    Eligible member profiles; candidates is empty when none remain.

    Esquema
    TeamMemberCandidates
    • candidatesarray of TeamMemberCandidateobligatorio
      • user_refstringobligatorio

        pattern ^[A-Za-z0-9][A-Za-z0-9._:/-]{0,127}$

      • display_namestringobligatorio
      • emailstringobligatorio
      • kindstringobligatorio

        Valores permitidos: "human""service_account"

  • 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:

    Leer más

    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.

    Leer más

    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 `team-members.manage` 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.

  • 409

    An archived team takes no members, so it has no candidates. Codes: team-archived

  • 500

    Platform failure, rendered without internal cause details.

Generado a partir de los contratos de la plataforma en el commit 5954fbc1.

Explora la plataforma

Obtén tu primera key API

El registro está abierto. Cuatro pasos hasta tu primera llamada: crea tu cuenta, crea tu organización, crea tu API key y empieza a usarla.

  1. 01Crea tu cuenta
  2. 02Crea tu organización
  3. 03Crea tu API key
  4. 04Empieza a usarla