Skip to content
WAMP Cloud

Read one Publication

GET
/v1/sessions/{sessionId}/publications/{publicationId}
curl --request GET \
  --url https://example.com/v1/sessions/9f2b7c14-59d3-4f7a-b8e1-2a6c05d4e731/publications/9f2b7c14-59d3-4f7a-b8e1-2a6c05d4e731 \
  --header 'Authorization: Bearer <token>'

Requires wamp.cloud.sessions:read. Read this after a lost or timed-out publish response: the Publication id you minted is enough to learn the outcome without risking a second pull request. A non-terminal status (admitted, prepared, attempted) means the durable command is still being driven, so poll rather than re-issuing anything; succeeded carries the result you need for a merge, and failed carries lastError.code and will not retry itself. Ids from a different Session are 404.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
sessionId
required

A UUID identifying one Cloud resource; Session, Turn, Publication and Merge ids are minted by the caller so an ambiguous retry addresses the same durable command instead of creating a second one.

string format: uuid
Example
9f2b7c14-59d3-4f7a-b8e1-2a6c05d4e731

A UUID you mint and own; it is the idempotency key for creation and the address of every Turn, artifact and publication underneath

publicationId
required

A UUID identifying one Cloud resource; Session, Turn, Publication and Merge ids are minted by the caller so an ambiguous retry addresses the same durable command instead of creating a second one.

string format: uuid
Example
9f2b7c14-59d3-4f7a-b8e1-2a6c05d4e731

A UUID you mint for this publish attempt; it is the idempotency and recovery key for the pull request

Responses

Section titled “Responses”

200

Section titled “200”

Publication

Media typeapplication/json

Envelope returned when a Publication is created or read.

object
publication
required

The Publication as it stands after this request; a 201 means it was newly admitted and a 200 means an identical retry returned the stored command

object
id
required

The caller-owned Publication id, which is also the retry and recovery unit

string format: uuid
sessionId
required

Session whose reviewed changes are being published

string format: uuid
status
required

admitted on acceptance, prepared once the local commit exists, attempted while the provider write is in flight, then terminal succeeded or failed

string
Allowed values: admitted prepared attempted succeeded failed
revision
required

The review revision this Publication is permanently pinned to

string
/^[a-f0-9]{64}$/
title
required

Pull-request title as submitted

string
result

Present once status is succeeded — the WAMP-owned branch, the exact commit pushed, and the pull request, where reused means an existing open pull request was recovered instead of a new one being opened

object
branch
required
string
commitSha
required

Lowercase hex 40-character Git object id naming an exact commit or tree in the source repository.

string
/^[a-f0-9]{40}$/
pullRequest
required
object
number
required
integer
url
required
string format: uri
draft
required
boolean
reused
required
boolean
lastError

Coarse machine code for the failure; present when status is failed

object
code
string
createdAt
required

When the Publication was admitted

string format: date-time
updatedAt
required

Last durable state change of the command

string format: date-time
completedAt

When the Publication reached succeeded or failed

string format: date-time
Example
{
  "publication": {
    "id": "1e8d4b62-7f05-4c3a-9d21-6a48f0b7c952",
    "sessionId": "9f2b7c14-59d3-4f7a-b8e1-2a6c05d4e731",
    "status": "succeeded",
    "revision": "88b7d76865ac445123d1adb83bf4e8e039e16bc02c5c675725a62a849f514441",
    "title": "Rate limit the payments endpoint",
    "result": {
      "branch": "wamp/publications-v1/cloud-9f2b7c14-59d3-4f7a-b8e1-2a6c05-d8af1a5a",
      "commitSha": "281c35bbe1f0ed047127957c11858d1394722abf",
      "pullRequest": {
        "number": 482,
        "url": "https://github.com/acme/checkout-service/pull/482",
        "draft": true,
        "reused": false
      }
    },
    "createdAt": "2026-08-12T09:52:31Z",
    "updatedAt": "2026-08-12T09:52:39Z",
    "completedAt": "2026-08-12T09:52:39Z"
  }
}

404

Section titled “404”

The resource is missing or inaccessible

Media typeapplication/json

Failure body returned with every non-2xx JSON response; branch on the machine code, never on prose or on the HTTP status alone.

object
error
required

Stable machine code

string
requiredScope

The installation capability the presented credential lacks, returned with insufficient_scope so an integrator knows exactly which capability to request

string
retryAfterSeconds

Advisory seconds to wait before retrying; returned on rate-limit denials, where the Retry-After header carries the same value

integer
>= 1
key
additional properties
any
Example
{
  "error": "cloud_session_not_found"
}