links

GET /v1/content/runs/{runId}

One run, with every site's outcome.

Alle links-eindpunten

Authenticatie

Stuur een API-sleutel mee als bearer token. Dit eindpunt vermeldt geen specifieke toestemming in de specificatie, dus geef uw sleutel de minimale rechten die nodig zijn en controleer het antwoord in plaats van zomaar wat aan te nemen.

Dit eindpunt vereist geen organisatie-id. Uw sleutel identificeert al de organisatie waartoe deze behoort, en het antwoord is hierop afgestemd.

Probeer het

Vervang alles tussen punthaakjes door uw eigen waarden en de sleutelplaatsvervanger door een sleutel uit uw dashboard.

curl -X GET https://api.zinndigital.com/v1/content/runs/{runId} \
  -H "Authorization: Bearer zdk_live_…"

Ingelogd? De API-console in je dashboard vult je echte organisatie-id en je eigen sleutel in, en voert het verzoek uit tegen de live API zodat je de daadwerkelijke respons kunt zien. Open dit eindpunt in de API-console

Details

The whole run screen in one call. Gated on `links.view`. 404 rather than 403 for a run in another tenant — a 403 would confirm the row exists.

Parameters

NaamTypeVerplichtWat dit is
runId (path)stringJa

Reactie

NaamTypeVerplichtWat dit is
idstringJa
stateContentRunStateJaWhere a run got to. `partial` is a real, honest, terminal answer and not a euphemism: some sites published and some did not, nothing is left to try, and the failures can be resu…
publish_policyContentRunPublishPolicyJaHow far a run may go on its own. `draft_only` is the default and puts nothing live.
recipe_idstringNee
briefstringJa
categorystringNee
post_idstringNeeThe article this run wrote. Written once and reused for every site, so a resumed run places the SAME copy rather than paying for a second generation.
attemptintegerJaWhich pass over the failures this is. 0 is the original run.
workflow_idstringNee
totalsContentRunTotalsJa
reasonContentRunFailureReasonNee
providerstringNee
messagestringNeeAn English sentence for the customer. Clients should render their own localised text from `reason` and fall back to this only for a code they do not know.
resumablebooleanJaWhether a resume would actually do anything. False on a paused run with nothing failed — do not offer the button when this is false.
started_atstringNee
finished_atstringNee
created_atstringJa
itemsContentRunItem[]Ja

Fouten die dit eindpunt kan retourneren

401 · 403 · 404