Publish workflow

post

https://api.joinpopp.com/v1/workflows/{workflowId}/publish

Publishes the workflow's working draft as a new live version. Popp checks the draft first, and a failed publish changes nothing.

A question keeps its published slug. Publish matches a draft question to a live question in the same outreach node by its id first, then by exactly the same content when no other question in either node has that content. A matched question under a different slug is refused with QUESTION_SLUG_CHANGED. The successful response lists the published question slugs this version no longer has in removedQuestionSlugs.

Configuration validation lists every check and error code.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200The new version is live and accepts runs.

400Publish was refused, and the error says why. For example, the workflow is paused or archived, or the error is ATS_JOB_ALREADY_CONNECTED, RUBRIC_GENERATION_FAILED or JOB_SUMMARY_GENERATION_FAILED.

401The x-api-key or x-organization-id header is missing.

403The workflow belongs to another organization.

404No workflow has this ID.

409Another publish of this workflow ran at the same time.

422The draft failed one or more checks, and validation.errors lists each one. Also the answer to a body that is not valid JSON.

500Something failed on our side.

503Popp could not finish a check, for example because your ATS was unreachable. Send the same request again after the Retry-After delay.