Update a playbook

PATCH 
/api/v1/playbooks/:playbook_id

Updates any of name, description and definition. Only a change to definition archives a new version; a rename or a rewrite of the definition the playbook already holds leaves version where it is. A case keeps the version it was created on.

A new version is authored by the caller, checked as on create: 403 PLAYBOOK_EXECUTOR_FORBIDDEN for an executor it may not start, 409 PLAYBOOK_AUTHOR_UNAVAILABLE for a trigger or OAuth token.

Request

Responses

200

Playbook updated

400

Bad request — a malformed or invalid definition

401

Unauthorized

403

Forbidden

404

Playbook not found

409

The resource has moved past the version this write read (VERSION_CONFLICT): a stated expected_version or If-Match no longer matches, or a concurrent write took the version first. meta.current_version names the version in force. Nothing is written.