GETMD

API reference / v1

The contract, rendered without hiding the contract.

25 operations are generated from the same OpenAPI document used for contract tests and client generation. Expand an operation for its stable identifier and request URL.

Download OpenAPI YAMLDownload OpenAPI JSON

Endpoints

All production requests use HTTPS and a bearer credential. Create operations also require an Idempotency-Key.

GET /v1/capabilities | Describe supported sources, outputs, languages, and limits

Describe supported sources, outputs, languages, and limits Operation ID: getCapabilities. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

getCapabilitieshttp
GET https://api.getmd.xyz/v1/capabilities
GET /v1/files/{file_id} | Get an account-owned file

Get an account-owned file Operation ID: getFile. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

getFilehttp
GET https://api.getmd.xyz/v1/files/{file_id}
DELETE /v1/files/{file_id} | Delete an account-owned file

Delete an account-owned file Operation ID: deleteFile. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

deleteFilehttp
DELETE https://api.getmd.xyz/v1/files/{file_id}
POST /v1/files/{file_id}/complete | Confirm a direct upload and start validation

Confirm a direct upload and start validation Operation ID: completeFileUpload. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

completeFileUploadhttp
POST https://api.getmd.xyz/v1/files/{file_id}/complete
GET /v1/jobs | List jobs using cursor pagination

List jobs using cursor pagination Operation ID: listJobs. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

listJobshttp
GET https://api.getmd.xyz/v1/jobs
POST /v1/jobs | Create a durable conversion job

Create a durable conversion job Operation ID: createJob. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

createJobhttp
POST https://api.getmd.xyz/v1/jobs
GET /v1/jobs/{job_id} | Get job status and progress

Get job status and progress Operation ID: getJob. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

getJobhttp
GET https://api.getmd.xyz/v1/jobs/{job_id}
DELETE /v1/jobs/{job_id} | Delete a terminal job and its outputs

Delete a terminal job and its outputs Operation ID: deleteJob. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

deleteJobhttp
DELETE https://api.getmd.xyz/v1/jobs/{job_id}
POST /v1/jobs/{job_id}/cancel | Request cooperative job cancellation

Request cooperative job cancellation Operation ID: cancelJob. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

cancelJobhttp
POST https://api.getmd.xyz/v1/jobs/{job_id}/cancel
GET /v1/jobs/{job_id}/outputs | List outputs for a job

List outputs for a job Operation ID: listJobOutputs. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

listJobOutputshttp
GET https://api.getmd.xyz/v1/jobs/{job_id}/outputs
POST /v1/jobs/{job_id}/outputs | Create another output from an existing job

Create another output from an existing job Operation ID: createJobOutput. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

createJobOutputhttp
POST https://api.getmd.xyz/v1/jobs/{job_id}/outputs
GET /v1/outputs/{output_id} | Get output metadata and artifact manifest

Get output metadata and artifact manifest Operation ID: getOutput. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

getOutputhttp
GET https://api.getmd.xyz/v1/outputs/{output_id}
GET /v1/outputs/{output_id}/content | Read output content using an optional opaque cursor

Read output content using an optional opaque cursor Operation ID: getOutputContent. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

getOutputContenthttp
GET https://api.getmd.xyz/v1/outputs/{output_id}/content
POST /v1/upload-intents | Create a direct-upload intent

Create a direct-upload intent Operation ID: createUploadIntent. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

createUploadIntenthttp
POST https://api.getmd.xyz/v1/upload-intents
GET /v1/usage | Get usage for the current billing period

Get usage for the current billing period Operation ID: getUsage. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

getUsagehttp
GET https://api.getmd.xyz/v1/usage
GET /v1/webhook-endpoints | List registered webhook endpoints

List registered webhook endpoints Operation ID: listWebhookEndpoints. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

listWebhookEndpointshttp
GET https://api.getmd.xyz/v1/webhook-endpoints
POST /v1/webhook-endpoints | Register a signed webhook endpoint

Register a signed webhook endpoint Operation ID: createWebhookEndpoint. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

createWebhookEndpointhttp
POST https://api.getmd.xyz/v1/webhook-endpoints
PATCH /v1/webhook-endpoints/{endpoint_id} | Update a webhook URL, description, or event subscriptions

Update a webhook URL, description, or event subscriptions Operation ID: updateWebhookEndpoint. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

updateWebhookEndpointhttp
PATCH https://api.getmd.xyz/v1/webhook-endpoints/{endpoint_id}
DELETE /v1/webhook-endpoints/{endpoint_id} | Delete a webhook endpoint

Delete a webhook endpoint Operation ID: deleteWebhookEndpoint. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

deleteWebhookEndpointhttp
DELETE https://api.getmd.xyz/v1/webhook-endpoints/{endpoint_id}
GET /v1/webhook-endpoints/{endpoint_id}/deliveries | List redacted delivery attempts

List redacted delivery attempts Operation ID: listWebhookDeliveries. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

listWebhookDeliverieshttp
GET https://api.getmd.xyz/v1/webhook-endpoints/{endpoint_id}/deliveries
POST /v1/webhook-endpoints/{endpoint_id}/deliveries/{delivery_id}/replay | Replay a dead-lettered delivery with the same event ID

Replay a dead-lettered delivery with the same event ID Operation ID: replayWebhookDelivery. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

replayWebhookDeliveryhttp
POST https://api.getmd.xyz/v1/webhook-endpoints/{endpoint_id}/deliveries/{delivery_id}/replay
POST /v1/webhook-endpoints/{endpoint_id}/pause | Pause webhook delivery

Pause webhook delivery Operation ID: pauseWebhookEndpoint. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

pauseWebhookEndpointhttp
POST https://api.getmd.xyz/v1/webhook-endpoints/{endpoint_id}/pause
POST /v1/webhook-endpoints/{endpoint_id}/resume | Resume webhook delivery

Resume webhook delivery Operation ID: resumeWebhookEndpoint. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

resumeWebhookEndpointhttp
POST https://api.getmd.xyz/v1/webhook-endpoints/{endpoint_id}/resume
POST /v1/webhook-endpoints/{endpoint_id}/rotate-secret | Rotate the endpoint signing secret

Rotate the endpoint signing secret Operation ID: rotateWebhookEndpointSecret. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

rotateWebhookEndpointSecrethttp
POST https://api.getmd.xyz/v1/webhook-endpoints/{endpoint_id}/rotate-secret
POST /v1/webhook-endpoints/{endpoint_id}/test | Queue a signed test event

Queue a signed test event Operation ID: testWebhookEndpoint. Authentication and standard problem responses are defined in the downloadable OpenAPI contract.

testWebhookEndpointhttp
POST https://api.getmd.xyz/v1/webhook-endpoints/{endpoint_id}/test

Contract files

Use YAML for human review and JSON for toolchains that prefer direct JSON input.

OpenAPI 3.1 YAMLCanonical generated contract.OpenAPI 3.1 JSONBuild-equivalent JSON representation.

Safe client behavior

Preserve request IDs and problem codes, honor Retry-After, and never infer ownership from a caller-supplied organization identifier.

Platform behavior