marketing

Rework a project

Save a new version of a project: different words, different scenes, different music, a different speed or look, or a restore of an earlier version. expectedRevisionId is a compare-and-set against the project's CURRENT revision — if somebody else saved in the meantime it is 409 revision_conflict with the id that won, and nothing is written. Parts the customer has locked are not moved by a re-plan. Every version is kept, so every change is undoable.

post/marketing/projects/{id}/revisions

Request

  • Base URL: https://api.gogoscreen.com/api/v1
  • URL: https://api.gogoscreen.com/api/v1/marketing/projects/{id}/revisions
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

idstring uuid required

The resource id, from a create answer or the matching list.

Headers

Idempotency-Keystring required

1–128 characters, unique to this request. A retry with the same key and the same body returns the STORED response with Idempotent-Replayed: true; the same key with a different body is 409 idempotency_conflict; a duplicate still in flight is 409 idempotency_in_progress. Claims expire after 24 hours.

Request body

copyobject

The words, by role.

expectedRevisionIdstring uuid required

The revision you are changing. A compare-and-set: 409 if it is no longer current.

locksobject

The parts to pin against a re-plan.

musicobject
restoreRevisionIdstring uuid

Restore an earlier version as a NEW one; the history is never rewritten.

scenesobject

Which picture fills which slot.

speednumber
styleobject

Response

Rework a project

currentRevisionIdstring required

Changes

No recorded changes to this operation across all 1 revision of this API.