Update workflow

Full update of a workflow's details: optional fields that are omitted are cleared. Tasks and managers are left unchanged (managers are set via /api/workflows/{workflow}/managers). Re-enabling a workflow resumes processing of its queued entries. First retrieve the current workflow from /api/workflows/{id}, apply your changes, then send back the full object.

Required permission: Full Write Workflows

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
int32
required
≥ 1

The id of the workflow

Body Params

The details of the workflow

string | null
required

The name of the workflow.

buffer
object | null
required

The re-entry buffer: how long after leaving the workflow a person must wait before they can re-enter it.

string | null

The description of the workflow.

boolean

Whether the workflow is enabled.

category
object | null

The workflow's category. Null when the workflow has no category. On writes, provide the id or code; values come from /api/property_values/workflow_categories/values.

layout
object | null

The editor layout of the workflow: vertical or horizontal. On writes, provide the code; defaults to vertical when omitted.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses
200

OK

401

Authentication is required, or the Ocs-Api-Key header is missing or invalid.

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/plain
application/json
text/json