Organization endpoints

Generated from the central API contract. Availability and permissions are checked by the connected service.

GET /v1/organization/team

Members, pending invitations and seats

Authorization: usage:read Current resource access and role checks also apply.

MCP: No dedicated tool in the current catalogue; use REST with the required permissions.

HTTP request pattern: replace path/query placeholders and prepare any body from the linked model. Run mutations only for your intended action; session-only endpoints need their application authentication context.

curl --fail-with-body --silent --show-error -X GET \
  -H "Authorization: Bearer $GD_API_KEY" \
  "$GD_API_BASE/v1/organization/team"

These are the response shapes declared by OpenAPI. Permission, validation, budget and service errors can also occur; see errors and recovery. An unconstrained JSON response is not a guarantee of undocumented fields.

POST /v1/organization/invitations

Invite someone by email (owners and admins); an existing account is added at once

Authorization: usage:read Current resource access and role checks also apply.

MCP: No dedicated tool in the current catalogue; use REST with the required permissions.

Request body: application/json — Invitation. Required.

HTTP request pattern: replace path/query placeholders and prepare any body from the linked model. Run mutations only for your intended action; session-only endpoints need their application authentication context.

curl --fail-with-body --silent --show-error -X POST \
  -H "Authorization: Bearer $GD_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @request.json \
  "$GD_API_BASE/v1/organization/invitations"

These are the response shapes declared by OpenAPI. Permission, validation, budget and service errors can also occur; see errors and recovery. An unconstrained JSON response is not a guarantee of undocumented fields.

DELETE /v1/organization/invitations/{invitation_id}

Revoke a pending invitation

Authorization: usage:read Current resource access and role checks also apply.

MCP: No dedicated tool in the current catalogue; use REST with the required permissions.

Parameter

Location

Required

Type / values

invitation_id

path

Yes

string (uuid)

HTTP request pattern: replace path/query placeholders and prepare any body from the linked model. Run mutations only for your intended action; session-only endpoints need their application authentication context.

curl --fail-with-body --silent --show-error -X DELETE \
  -H "Authorization: Bearer $GD_API_KEY" \
  "$GD_API_BASE/v1/organization/invitations/REPLACE_INVITATION_ID"

HTTP status

Response schema

204

Successful Response

401

ErrorResponse

403

ErrorResponse

404

ErrorResponse

409

ErrorResponse

413

ErrorResponse

422

ErrorResponse

429

ErrorResponse

500

ErrorResponse

503

ErrorResponse

402

PaymentRequiredResponse

These are the response shapes declared by OpenAPI. Permission, validation, budget and service errors can also occur; see errors and recovery. An unconstrained JSON response is not a guarantee of undocumented fields.

POST /v1/organization/leave

Leave the workspace (its only owner closes it or names another owner instead)

Authorization: usage:read Current resource access and role checks also apply.

MCP: No dedicated tool in the current catalogue; use REST with the required permissions.

HTTP request pattern: replace path/query placeholders and prepare any body from the linked model. Run mutations only for your intended action; session-only endpoints need their application authentication context.

curl --fail-with-body --silent --show-error -X POST \
  -H "Authorization: Bearer $GD_API_KEY" \
  "$GD_API_BASE/v1/organization/leave"

HTTP status

Response schema

204

Successful Response

401

ErrorResponse

403

ErrorResponse

404

ErrorResponse

409

ErrorResponse

413

ErrorResponse

422

ErrorResponse

429

ErrorResponse

500

ErrorResponse

503

ErrorResponse

402

PaymentRequiredResponse

These are the response shapes declared by OpenAPI. Permission, validation, budget and service errors can also occur; see errors and recovery. An unconstrained JSON response is not a guarantee of undocumented fields.

PATCH /v1/organization/members/{user_id}

Make a member an owner, admin or member

Authorization: usage:read Current resource access and role checks also apply.

MCP: No dedicated tool in the current catalogue; use REST with the required permissions.

Parameter

Location

Required

Type / values

user_id

path

Yes

string

Request body: application/json — RoleChange. Required.

HTTP request pattern: replace path/query placeholders and prepare any body from the linked model. Run mutations only for your intended action; session-only endpoints need their application authentication context.

curl --fail-with-body --silent --show-error -X PATCH \
  -H "Authorization: Bearer $GD_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @request.json \
  "$GD_API_BASE/v1/organization/members/REPLACE_USER_ID"

These are the response shapes declared by OpenAPI. Permission, validation, budget and service errors can also occur; see errors and recovery. An unconstrained JSON response is not a guarantee of undocumented fields.

DELETE /v1/organization/members/{user_id}

Remove someone from the organisation

Authorization: usage:read Current resource access and role checks also apply.

MCP: No dedicated tool in the current catalogue; use REST with the required permissions.

Parameter

Location

Required

Type / values

user_id

path

Yes

string

HTTP request pattern: replace path/query placeholders and prepare any body from the linked model. Run mutations only for your intended action; session-only endpoints need their application authentication context.

curl --fail-with-body --silent --show-error -X DELETE \
  -H "Authorization: Bearer $GD_API_KEY" \
  "$GD_API_BASE/v1/organization/members/REPLACE_USER_ID"

HTTP status

Response schema

204

Successful Response

401

ErrorResponse

403

ErrorResponse

404

ErrorResponse

409

ErrorResponse

413

ErrorResponse

422

ErrorResponse

429

ErrorResponse

500

ErrorResponse

503

ErrorResponse

402

PaymentRequiredResponse

These are the response shapes declared by OpenAPI. Permission, validation, budget and service errors can also occur; see errors and recovery. An unconstrained JSON response is not a guarantee of undocumented fields.

GET /v1/organization/closure

What closing this workspace would do: members, projects, jobs, subscription

Authorization: usage:read Current resource access and role checks also apply.

MCP: No dedicated tool in the current catalogue; use REST with the required permissions.

HTTP request pattern: replace path/query placeholders and prepare any body from the linked model. Run mutations only for your intended action; session-only endpoints need their application authentication context.

curl --fail-with-body --silent --show-error -X GET \
  -H "Authorization: Bearer $GD_API_KEY" \
  "$GD_API_BASE/v1/organization/closure"

These are the response shapes declared by OpenAPI. Permission, validation, budget and service errors can also occur; see errors and recovery. An unconstrained JSON response is not a guarantee of undocumented fields.

POST /v1/organization/close

Close this workspace (owners; confirm with its name). Its data is deleted after 30 days

Authorization: usage:read Current resource access and role checks also apply.

MCP: No dedicated tool in the current catalogue; use REST with the required permissions.

Request body: application/json — Confirmation. Required.

HTTP request pattern: replace path/query placeholders and prepare any body from the linked model. Run mutations only for your intended action; session-only endpoints need their application authentication context.

curl --fail-with-body --silent --show-error -X POST \
  -H "Authorization: Bearer $GD_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @request.json \
  "$GD_API_BASE/v1/organization/close"

These are the response shapes declared by OpenAPI. Permission, validation, budget and service errors can also occur; see errors and recovery. An unconstrained JSON response is not a guarantee of undocumented fields.