API reference

API reference

The Spark HTTP API: base URL, workspace paths, and how to make a first request.

Base URL

All Spark API requests go to a single base URL. The API is versioned in the path.

Base URL

https://api.spark.graphon.ai/v1

Workspace paths

Machine routes live under /v1/workspaces/{workspaceId}. A key belongs to one workspace. Use it to manage members, invitations, service accounts, and API keys.

Shape

  • The API uses JSON request and response bodies with camelCase fields.
  • List routes return an items array.
  • Errors use a consistent JSON shape. See Errors.

Make a first request

List the members in your workspace.

cURL

curl \
  --url "https://api.spark.graphon.ai/v1/workspaces/wspQ7WsH2Np5L/members" \
  --header "Authorization: Bearer $SPARK_API_KEY"

Machine-readable contract

The OpenAPI document for this reference is published at a stable URL: /openapi.json. The API host serves the same document at /openapi.json.

Was this page helpful?