Spec0docsCLI 0.7.0
API Explorer

"Is this git SHA the last published spec for this API?"

Powers incremental publish in CI — caller posts current gitSha, gets back whether a publish is needed.

GET
/api/v1/public/specs/sync-status

Authorization

BearerAuth
AuthorizationBearer <token>

Bearer token. Either a Personal Access Token (pat_...) or a Service Account Token (sat_...). Issued via the Spec0 dashboard or /me/personal-access-tokens.

In: header

Query Parameters

gitSha*string
apiId?string
Formatuuid
name?string

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://app.spec0.io/api/v1/public/specs/sync-status?gitSha=string"
{
  "apiId": "2500ac85-f71b-4d01-b32c-62f3af3fe2c5",
  "needsPublish": true,
  "lastPublishedSha": "string",
  "lastPublishedVersion": "string"
}
{
  "status": 0,
  "title": "string",
  "detail": "string",
  "type": "string",
  "instance": "string"
}
{
  "error": "string",
  "message": "string"
}
{
  "status": 0,
  "title": "string",
  "detail": "string",
  "type": "string",
  "instance": "string"
}
{
  "status": 0,
  "title": "string",
  "detail": "string",
  "type": "string",
  "instance": "string"
}
Was this helpful?