Add Delivery Status

Add Delivery Status

Required scope: public-api:write

Description

This endpoint allows to provide updates for a document/publication regarding its status in an external delivery system (e.g. page build status in a static site generator).
The response is a JSON object including the reportId.
If you want to know more about how to setup a Delivery Build, you can find a guide here.

Use Cases
  • Report build status of publications in an external system like an e-paper which has a “build” stage involved
Curl Example
ACCESS_TOKEN=ey1234
curl -k -X POST "https://server.livingdocs.io/api/v1/documents/:documentId/addDeliveryStatus" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json; charset=utf-8" \
  --data-binary @- << EOF
  {
    "reportId": "2SG2MAA9RwPn",
    "publicationId": 524,
    "deliveryHandle": "web",
    "status": "success",
    "message": "Message with <strong>html</strong>"
  }
EOF

Endpoint

POST api/v1/documents/:documentId/addDeliveryStatus

Parameters

NameTypeRequiredNotes
:documentIdintegerx
reportIdstringif provided this will update the record, otherwise it will create a new one with a new reportId
publicationIdintegerx
deliveryHandlestringx
statusstringxOne of: “success”, “failed”, “in-progress”
messagestringString or sanitized HTML

Response

200
OK
api/v1/documents/222/addDeliveryStatus
{reportId: '0TAW2ORdNjuM'}