SparQDocs
GuidesAPI referencesparqhq.ai
API referenceIdentity

Geo Discovery

GET
/.well-known/sparq-discovery

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.

The signed list of geos and their endpoints. Fetched before any credential is sent; check the signature against the trust anchors pinned in the SDK.

Response Body

Successful Response

application/json
  1. response
version*Version

Rises with every change; never goes back.

Range1 <= value
issued_at*Issued At
Formatdate-time
expires_at*Expires At

At most 24 hours after issued_at.

Formatdate-time
geos*array<>
signature*Signature

Compact JWS (ES256) over the document without this field, by one of the pinned trust-anchor keys.

Example Request
curl -X GET 'http://dev-sparq.centralindia.cloudapp.azure.com:8000/.well-known/sparq-discovery'
Example Response200
{  "version": 1,  "issued_at": "2019-08-24T14:15:22Z",  "expires_at": "2019-08-24T14:15:22Z",  "geos": [    {      "geo_id": "eu",      "api_endpoint": "http://example.com",      "admin_endpoint": "http://example.com",      "regions": [        "westeurope"      ]    }  ],  "signature": "string"}

Ready GET

Dependencies are reachable. Redis joins the checks when Sparq first uses it.

Introspect Tool Token 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. RFC 7662 for delegated tool tokens: a tool asks before a write whether the token is still active. Called with the tool's own credential.