Skip to documentation
API v1

MetaGhost Cloud API

Process images and videos from your server. Send a file, approve a credit quote and retrieve the result.

Quickstart

In your account, open Cloud API and create a key with Read credits permission. Set METAGHOST_API_KEY and METAGHOST_BASE_URL on your server using the values shown there. This first request reads the balance without spending credits.

cURL
curl --fail-with-body --request GET \
  "$METAGHOST_BASE_URL/credits" \
  --header "Authorization: Bearer $METAGHOST_API_KEY"
Python / Node.js
Python
import os
import json
import urllib.request

base = os.environ["METAGHOST_BASE_URL"].rstrip("/")
headers = {
  "Authorization": "Bearer " + os.environ["METAGHOST_API_KEY"]
}
request = urllib.request.Request(
    base + "/credits",
    method="GET", headers=headers
)
with urllib.request.urlopen(request, timeout=30) as response:
    print(json.load(response))
Node.js
// Node.js 24: run on your server.
const base = process.env.METAGHOST_BASE_URL?.replace(/\/$/, "");
const token = process.env.METAGHOST_API_KEY;
if (!base || !token) throw new Error("Missing API configuration");

const response = await fetch(base + "/credits", {
  method: "GET",
  headers: {
    "Authorization": `Bearer ${token}`
  },
  signal: AbortSignal.timeout(30_000),
});
const result = await response.json();
if (!response.ok) throw new Error(JSON.stringify(result));
console.log(result);

Business and Scale include API access by default. Team permissions and existing grants also apply. Choose Never to keep your key across renewals. It works only while the original account or team has API access. You can revoke it at any time. Store the key on your server and send it as a Bearer token.

Process an image

This Python 3.10+ example sends one JPEG up to 5 MiB and saves the result to a new file. Give its Cloud key the assets:write, quotes:write, batches:write and jobs:read permissions. The command submits the batch only if its quote fits the credit limit you set.

Terminal
python3 quickstart.py image.jpg result.jpg --max-credits 20
Download quickstart.py
  1. POST /assets · Create an upload, send the bytes to the signed URL with its required headers, then finalize and wait for ready.
  2. POST /quotes · Quote one output using the verified asset ID, version and the image.spoof.simple operation.
  3. POST /batches · Submit the quote ID and approved amount. Save the Idempotency-Key and exact request body so a lost response can be recovered.
  4. GET /results/{resultId} · After the batch succeeds, read its jobs, get the signed download URL and verify the SHA-256 before saving.

Check GET /capabilities for active operations and limits. Video SynthID accepts up to 10 seconds per source, including in Advanced and Spoof Pro when they run SynthID.

Credit pricing

Simple images cost 10 credits per megapixel per output, rounded up to a whole credit. Simple video costs 3 credits per second per output at 1920 × 1080 and 30 fps.

1 MP
10 credits
1080p · 10 s
30 credits
1080p · 60 s
180 credits

Resolution, frame rate, outputs and AI options affect the total. The server quote is authoritative. Submitting a batch reserves credits. Recent API usage shows charges for completed work.

API reference

Use the base URL from your account ending in /api/cloud/v1.

Search by path, method or scope. Open a route to view its permissions and schemas. Quickstart routes include examples.

123 endpoints

Quickstart routes

GET/credits

Scopes · credits:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

cURL
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request GET \
  "$METAGHOST_BASE_URL/credits" \
  --header "Authorization: Bearer $METAGHOST_API_KEY"
GET/capabilities

Scopes · jobs:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

cURL
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request GET \
  "$METAGHOST_BASE_URL/capabilities" \
  --header "Authorization: Bearer $METAGHOST_API_KEY"
POST/assets

Scopes · assets:write

HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

cURL
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request POST \
  "$METAGHOST_BASE_URL/assets" \
  --header "Authorization: Bearer $METAGHOST_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: example-request-0001" \
  --data '{
  "filename": "image.jpg",
  "byteLength": 12345,
  "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "mediaType": "image/jpeg"
}'
POST/assets/{assetId}/finalize

Scopes · assets:write

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

cURL
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request POST \
  "$METAGHOST_BASE_URL/assets/{assetId}/finalize" \
  --header "Authorization: Bearer $METAGHOST_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: example-request-0001" \
  --data '{
  "byteLength": 12345,
  "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
}'
GET/assets/{assetId}

Scopes · assets:write

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

cURL
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request GET \
  "$METAGHOST_BASE_URL/assets/{assetId}" \
  --header "Authorization: Bearer $METAGHOST_API_KEY"
POST/quotes

Scopes · quotes:write

HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

cURL
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request POST \
  "$METAGHOST_BASE_URL/quotes" \
  --header "Authorization: Bearer $METAGHOST_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: example-request-0001" \
  --data '{
  "operation": "image.spoof.simple",
  "inputs": [
    {
      "asset": {
        "assetId": "ca_00000000000000000000000000000001",
        "version": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      },
      "variants": 1
    }
  ],
  "options": {}
}'
POST/batches

Scopes · batches:write, jobs:read

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

cURL
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request POST \
  "$METAGHOST_BASE_URL/batches" \
  --header "Authorization: Bearer $METAGHOST_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Idempotency-Key: example-request-0001" \
  --data '{
  "quoteId": "cq_00000000000000000000000000000001",
  "maxCredits": 10
}'
GET/batches/{batchId}

Scopes · jobs:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

cURL
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request GET \
  "$METAGHOST_BASE_URL/batches/{batchId}" \
  --header "Authorization: Bearer $METAGHOST_API_KEY"
GET/batches/{batchId}/jobs

Scopes · jobs:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

cURL
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request GET \
  "$METAGHOST_BASE_URL/batches/{batchId}/jobs" \
  --header "Authorization: Bearer $METAGHOST_API_KEY"
GET/results/{resultId}

Scopes · jobs:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

cURL
# Base: https://YOUR_HOST/api/cloud/v1
# Set METAGHOST_BASE_URL and METAGHOST_API_KEY on your server.
curl --fail-with-body --request GET \
  "$METAGHOST_BASE_URL/results/{resultId}" \
  --header "Authorization: Bearer $METAGHOST_API_KEY"

Files, presets and jobs

GET/jobs/{jobId}/caption-review

Scopes · jobs:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

PATCH/jobs/{jobId}/caption-review

Scopes · batches:write, jobs:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/jobs/{jobId}/caption-review/submit

Scopes · batches:write, jobs:read

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/presets/import

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/presets/export

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/presets

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/presets

Scopes · projects:write, projects:read

HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/presets/{presetId}

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

PATCH/presets/{presetId}

Scopes · projects:write, projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/presets/{presetId}

Scopes · projects:write, projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/presets/{presetId}/rename

Scopes · projects:write, projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/catalog

Scopes · jobs:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/assets/{assetId}

Scopes · assets:write

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/quotes/{quoteId}

Scopes · jobs:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/batches/{batchId}/cancel

Scopes · batches:write, jobs:read

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/jobs/{jobId}

Scopes · jobs:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

Studio and media library

POST/library-rebuilds

Scopes · projects:write, projects:read

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/library-rebuilds/{rebuildId}

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/library-rebuilds/{rebuildId}

Scopes · projects:write, projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/library-items/{libraryId}/preview

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/library-items

Scopes · projects:write, projects:read

HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/library-items

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/library-uploads

Scopes · projects:write, projects:read, assets:write

HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/library-uploads/{assetId}/finalize

Scopes · projects:write, projects:read, assets:write

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/library-items/stats

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/library-items/{libraryId}

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

PATCH/library-items/{libraryId}

Scopes · projects:write, projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/library-items/{libraryId}

Scopes · projects:write, projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/library-items/{libraryId}/content

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/studio-imports

Scopes · projects:write, projects:read, assets:write

HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/studio-transfers/{transferId}

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/studio-transfers/{transferId}

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/studio-transfers/{transferId}/finalize

Scopes · projects:write, projects:read, assets:write

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/studio-transfers/{transferId}/result

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/studio-templates/{templateId}/export

Scopes · projects:read

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/studio-templates

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/studio-templates

Scopes · projects:write, projects:read

HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/studio-templates/{templateId}/preview

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

PUT/studio-templates/{templateId}/preview

Scopes · projects:write, projects:read, jobs:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/studio-templates/{templateId}

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

PATCH/studio-templates/{templateId}

Scopes · projects:write, projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/studio-templates/{templateId}

Scopes · projects:write, projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

Captions and translation

POST/translations

Scopes · projects:write, projects:read

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/translations/{translationId}

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/translations/{translationId}

Scopes · projects:write, projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/translations/{translationId}/result

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/caption-projects

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/caption-projects

Scopes · projects:write, projects:read

HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/caption-projects/{projectId}

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

PATCH/caption-projects/{projectId}

Scopes · projects:write, projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/caption-projects/{projectId}

Scopes · projects:write, projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/caption-projects/{projectId}/subtitles

Scopes · projects:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/transcripts

Scopes · quotes:write, assets:write, jobs:read

HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/transcripts/{transcriptId}

Scopes · jobs:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/transcripts/{transcriptId}

Scopes · quotes:write

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/transcripts/{transcriptId}/start

Scopes · batches:write, jobs:read

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/captions/font-preview

Scopes · jobs:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

Downloader

POST/download-sessions

Scopes · assets:write

HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/download-sessions

Scopes · assets:write

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/download-sessions/{sessionId}

Scopes · assets:write

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/download-sessions/{sessionId}

Scopes · assets:write

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/download-batches

Scopes · assets:write

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/download-batches/{batchId}

Scopes · assets:write

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/download-batches/{batchId}

Scopes · assets:write

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/downloads

Scopes · assets:write

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/downloads/{downloadId}

Scopes · assets:write

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/downloads/{downloadId}

Scopes · assets:write

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/downloads/{downloadId}/result

Scopes · assets:write

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

Google Drive

POST/drive/connections/{connectionId}/outputs

Scopes · drive:write, drive:read

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/drive/outputs/{collectionId}

Scopes · drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/drive/outputs/{collectionId}

Scopes · drive:write, drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/drive/outputs/{collectionId}/items

Scopes · drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/drive/outputs/{collectionId}/recover

Scopes · drive:write, drive:read

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/drive/connections/{connectionId}/inputs

Scopes · drive:write, drive:read, assets:write

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/drive/inputs/{collectionId}

Scopes · drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/drive/inputs/{collectionId}

Scopes · drive:write, drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/drive/inputs/{collectionId}/items

Scopes · drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/drive/connections/{connectionId}/transfers

Scopes · drive:write, drive:read

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/drive/transfers/{transferId}

Scopes · drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/drive/transfers/{transferId}

Scopes · drive:write, drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/drive/transfers/{transferId}/recover

Scopes · drive:write, drive:read

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/drive/connections/{connectionId}/mutations

Scopes · drive:write, drive:read

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/drive/mutations/{mutationId}

Scopes · drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/drive/mutations/{mutationId}

Scopes · drive:write, drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/drive/mutations/{mutationId}/reconcile

Scopes · drive:write, drive:read

HTTP · 202, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/drive/connections/{connectionId}/thumbnail

Scopes · drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/drive/connections/{connectionId}/pickers

Scopes · drive:write, drive:read

HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/drive/pickers/{pickerId}

Scopes · drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/drive/pickers/{pickerId}

Scopes · drive:write, drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/drive/pickers/{pickerId}/items

Scopes · drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/drive/connections/{connectionId}/favorites

Scopes · drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

PUT/drive/connections/{connectionId}/favorites

Scopes · drive:write, drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/drive/connections/{connectionId}/favorites

Scopes · drive:write, drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/drive/connections/{connectionId}/files/query

Scopes · drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/drive/connections/{connectionId}/file

Scopes · drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/drive/authorizations

Scopes · drive:write, drive:read

HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/drive/authorizations/{authorizationId}

Scopes · drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/drive/connection

Scopes · drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/drive/connections/{connectionId}

Scopes · drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/drive/connections/{connectionId}

Scopes · drive:write, drive:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

Teams

GET/team/activity

Scopes · teams:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/team/activity/status

Scopes · teams:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/team/members

Scopes · teams:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/team/invitations

Scopes · teams:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/team/permissions

Scopes · teams:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/team/audit

Scopes · teams:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/team/presets

Scopes · teams:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/team/presets

Scopes · teams:write, teams:read

HTTP · 201, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

GET/team/presets/{presetId}

Scopes · teams:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

PATCH/team/presets/{presetId}

Scopes · teams:write, teams:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

DELETE/team/presets/{presetId}

Scopes · teams:write, teams:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

POST/team/presets/{presetId}/lock

Scopes · teams:write, teams:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

Account and limits

GET/performance

Scopes · jobs:read

HTTP · 200, 400, 401, 402, 403, 404, 409, 410, 413, 415, 422, 429, 503

Troubleshooting

401
Check that the Cloud key is present, valid and still active.
403
Check your subscription, team permissions and the scopes of the key.
409
Check the quote and replay the exact request with its original Idempotency-Key if the response was lost.
429
Wait for the delay in Retry-After before making another request.

Cloud MCP

Copy the MCP URL from the Cloud API page in your account. In your assistant, add a remote MCP server, choose Streamable HTTP and paste the URL. Enter your Cloud API key in the connector’s Bearer token field. The Desktop app can stay closed.

Use metaghost_cloud_getCredits with Read credits to check the connection. Give the key Process media to use quotes, batches and results. Add Projects or Google Drive for the corresponding workflows. Get a quote before starting a batch and set maxCredits. Upload the file with the signed upload URL or use a file already granted through Google Drive. The MCP returns temporary result links.

Drive recovery can verify an existing delivery or resume its upload. Open the consent and Picker links returned by the assistant in your browser, then return to the assistant to continue.

To connect an authenticated Downloader session, import its cookie file directly with POST /download-sessions outside the assistant. The MCP can then list, use and revoke the session by ID.