StudioHomepage
ServicesCatalogHTTP APIPublications

Recover a publication

POST
/api/catalog/projects/{project_id}/publications/recover

Find the result of a publication when you do not know if it completed. Send the transaction identity of the publication. The search uses the project and the authenticated caller. When the response has no publication, the publication can still complete later. Thus, when you retry, use the same transaction identity and idempotency key. You must have permission to recover publications in the project.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Path Parameters

project_id*string

Owning project identifier. Nonempty, at most 128 UTF-8 bytes, with no control characters. Project creation belongs to the project service.

Request Body

application/json
  1. body
transactionId*catalog.TransactionId

Caller-allocated UUIDv7 publication identity used to recover an uncertain result within a project and authenticated actor scope.

Formatuuid

Response Body

Success

application/json
  1. response

Recover whether a transaction published. notPublished is an observation and does not prevent a still-running publication from completing later.

notPublished*

Empty payload for a union variant without additional data.

type*unknown
curl -X POST 'https://api.spiraldb.dev/api/catalog/projects/string/publications/recover' \  -H 'Content-Type: application/json' \  -d '{  "transactionId": "75906707-8c31-479c-b354-aa805c4cefbc"}'
{  "notPublished": {},  "type": "notPublished"}