SparQDocs
GuidesAPI referencesparqhq.ai
API referenceChanges

Diff Draft

GET
/v1/admin/drafts/{draft_id}/diff

Not available yet. This operation is part of the published contract and answers 501 not_implemented until it is built. The request and response shapes below are final for this contract version.

Authorization

HTTPBearer
headerAuthorizationBearer <token>

Bearer credential. API keys look like sqk_<geo>_<key_id>_<secret>: treat them as opaque and never put one in a browser. Older keys without the geo part stay valid until rotated. Find a geo's endpoints through GET /.well-known/sparq-discovery before sending a key.

Path Parameters

draft_id*Draft Id
Formatuuid

Header Parameters

Sparq-Workspace?string

For a person signed in to a console with several workspaces: the workspace this call is for, one of their memberships (listMyMemberships). Without it such a person gets workspace_required (400); a workspace they are not a member of is forbidden. It never grants anything, and other callers' credentials ignore it.

Formatuuid

Response Body

Successful Response

application/json
  1. response

Side-by-side change against the live version, with quality, token and cost change.

draft_id*Draft Id
Formatuuid
against_version*|null
changes*array<>
pass_rate*|null
tokens_per_run*|null
cost_per_run_usd*|null
Example Request
curl -X GET 'http://dev-sparq.centralindia.cloudapp.azure.com:8000/v1/admin/drafts/497f6eca-6276-4993-bfeb-53cbbbba6f08/diff'
Example Response
{  "draft_id": "d998e5e8-954a-4a68-bb9e-7305e87278c0",  "against_version": "1.4.0",  "changes": [    {      "path": "string",      "op": "add",      "before": null,      "after": null    }  ],  "pass_rate": {    "before": "string",    "after": "string"  },  "tokens_per_run": {    "before": "string",    "after": "string"  },  "cost_per_run_usd": {    "before": "string",    "after": "string"  }}

Decide Change Request POST

> **Not available yet.** This operation is part of the published contract and answers `501 not_implemented` until it is built. The request and response shapes below are final for this contract version. Approve or reject. The author of the change request cannot approve it.

Evaluate Draft POST

> **Not available yet.** This operation is part of the published contract and answers `501 not_implemented` until it is built. The request and response shapes below are final for this contract version.