Customer.io
v1.0.0
OpenAPI 3.1.0

Get publish status

US region

Client Libraries
Shell Curl

Get publish status

​

Check the status of a multi-language publish that returned "status": "pending". Pass the publish_id from the Publish an email response. When the publish is still running, the response returns "status": "pending"; when it finishes, it returns "status": "done" with the template version mappings.

If the publish fails, this endpoint returns an error rather than a status. You get the same error a single-language publish returns inline—a 422 for liquid errors, a 409 when the destination campaign is backfilling, and so on.

Path Parameters
  • id
    Type: stringFormat: uuid
    required

    The UUID of the email. If your email has multiple languages, you must provide the ID of the default language template. This links the workflow to all of the language variants for the template.

Query Parameters
  • publish_id
    Type: string
    required

    The publish ID returned when a multi-language publish is pending.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/v1/design_studio/emails/{id}/publish_status
curl 'https://api.customer.io/v1/design_studio/emails/123e4567-e89b-12d3-a456-426614174000/publish_status?publish_id='

{
  "status": "done",
  "mappings": [
    {
      "node_id": "123e4567-e89b-12d3-a456-426614174000",
      "template_id": 987654,
      "version_id": "v_01H8XK",
      "language": ""
    }
  ]
}

Current publish status.