Cad endpoints

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

POST /v1/cad/reconstructions/uploads

Upload

Authorization: artifacts:write 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

project_id

query

Yes

string (uuid)

filename

query

Yes

string

Idempotency-Key

header

No

string

X-Content-SHA256

header

No

string

Request body: application/step — string (binary). Required.

Request body: model/3mf — string (binary). Required.

Request body: application/octet-stream — string (binary). 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 "Idempotency-Key: REPLACE_IDEMPOTENCY_KEY" \
  "$GD_API_BASE/v1/cad/reconstructions/uploads?project_id=REPLACE_PROJECT_ID&filename=REPLACE_FILENAME"

HTTP status

Response schema

201

JSON

401

ErrorResponse

403

ErrorResponse

404

ErrorResponse

409

ErrorResponse

413

ErrorResponse

422

ErrorResponse

429

ErrorResponse

500

ErrorResponse

503

ErrorResponse

402

PaymentRequiredResponse

200

Verified replay of an existing STEP or 3MF upload

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/cad/reconstructions/{reconstruction_id}

Get Reconstruction

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

MCP: get_cad_reconstruction

Parameter

Location

Required

Type / values

reconstruction_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 GET \
  -H "Authorization: Bearer $GD_API_KEY" \
  "$GD_API_BASE/v1/cad/reconstructions/REPLACE_RECONSTRUCTION_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.

GET /v1/cad/reconstructions/{reconstruction_id}/{role}

Content

Authorization: artifacts: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

reconstruction_id

path

Yes

string (uuid)

role

path

Yes

string

variant

query

No

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 GET \
  -H "Authorization: Bearer $GD_API_KEY" \
  "$GD_API_BASE/v1/cad/reconstructions/REPLACE_RECONSTRUCTION_ID/REPLACE_ROLE"

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/cad/reconstructions/{reconstruction_id}/edits

Edit

Authorization: geometry:write Current resource access and role checks also apply.

MCP: edit_reconstructed_cad

Parameter

Location

Required

Type / values

reconstruction_id

path

Yes

string (uuid)

Request body: application/json — ReconstructionEdit. 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/cad/reconstructions/REPLACE_RECONSTRUCTION_ID/edits"

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.