Hexel StudioDocs

Update approval workflow

PATCH/approvals/workflows/{workflow_id}

id, organization_id and timestamps cannot be changed. approver_role is validated as on create; an empty string clears it.

Path parameters

workflow_idstring

Workflow ID

Headers

Authorizationstring

Bearer <token>.

Returns

200OKApprovalWorkflow

approver_roleoptional string

approver_user_idsoptional array of string

created_atoptional string

descriptionoptional string

idoptional string

is_enabledoptional boolean

min_approvalsoptional integer

nameoptional string

organization_idoptional string

requires_approvaloptional boolean

scope_idoptional string

scope_typeoptional string

updated_atoptional string

workflow_typeoptional string

Errors

400Bad Request

PATCH Request

curl --request PATCH \
  --url 'https://api.hexelstudio.com/v1/approvals/workflows/{workflow_id}' \
  --header "Authorization: Bearer $ACCESS_TOKEN"

const res = await fetch("https://api.hexelstudio.com/v1/approvals/workflows/{workflow_id}", {
  method: "PATCH",
  headers: {
    Authorization: `Bearer ${process.env.ACCESS_TOKEN}`,
  },
})
const data = await res.json()

import os
import requests

res = requests.patch(
    "https://api.hexelstudio.com/v1/approvals/workflows/{workflow_id}",
    headers={"Authorization": f"Bearer {os.environ['ACCESS_TOKEN']}"},
)
data = res.json()

Response

{
  "approver_role": "string",
  "approver_user_ids": [
    "string"
  ],
  "created_at": "2026-01-01T00:00:00Z",
  "description": "string",
  "id": "string",
  "is_enabled": true,
  "min_approvals": 0,
  "name": "string",
  "organization_id": "string",
  "requires_approval": true,
  "scope_id": "string",
  "scope_type": "string",
  "updated_at": "2026-01-01T00:00:00Z",
  "workflow_type": "string"
}

{
  "key": "string"
}