Revoke Credentials
Not available yet. This operation is part of the published contract and answers
501 not_implementeduntil it is built. The request and response shapes below are final for this contract version.
Revoke up to 100 credentials. One result per credential, never all-or-nothing.
HTTPBearerAuthorizationBearer <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.
Sparq-Workspace?stringFor 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.
uuidIdempotency-Key?stringMakes a retry safe: the same key, route and body within 24 hours returns the stored response and the same result id. The same key with a different body or route is idempotency_conflict; while the first request runs, idempotency_in_progress.
8 <= length <= 128application/json- body
Body of POST /v1/admin/credentials/revoke-batch: up to 100 at once, one result each.
credential_ids*array<>1 <= items <= 100reason*Reason1 <= length <= 500Successful Response
application/json- response
items*array<>succeeded*Succeeded0 <= valuefailed*Failed0 <= valuecurl -X POST 'http://dev-sparq.centralindia.cloudapp.azure.com:8000/v1/admin/credentials/revoke-batch' \ -H 'Content-Type: application/json' \ -d '{ "credential_ids": [ "eeb3e499-2978-4746-969f-bf25b9bd719f" ], "reason": "string"}'{ "items": [ { "index": 0, "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "status": 200, "problem": { "type": "about:blank", "title": "string", "status": 400, "code": "no_compliant_model", "detail": "string", "instance": "string", "request_id": "string", "issues": [ { "path": "string", "message": "string" } ], "geo_id": "string" } } ], "succeeded": 0, "failed": 0}