Returns all workflows you have access to, across all workspaces, sorted by name. You can search by workflow name, but you cannot filter by a specific workspace.
Response 200
{
"items": [
{
"id": "dd36407c-e43d-4838-ea2f-08ded0fe5d37",
"name": "PPMS",
"workspace": "b3f...",
"image": "icon_3f9a.png",
"terminology": { "project": { "singular": "Project", "plural": "Projects" }, "activity": { "singular": "Activity", "plural": "Activities" } },
"color": "#2563eb",
"visibility": true,
"createdAt": "2025-01-10T08:00:00+00:00",
"updatedAt": "2026-03-01T12:00:00+00:00"
}
],
"page": 1,
"pageSize": 20,
"totalCount": 1,
"totalPages": 1
}
visibility: true means the workflow is public within the organization.
image is the raw file storage key, not a resolvable URL.
If a workflow's icon was removed through the web workflow, the image field may return the text "null" instead of a blank value. This is a known behaviour — if you're working with the image field, make sure your integration accounts for both cases.
terminology keys are lowercase (project, activity), and the whole field, or the singular/plural values inside it, can be null if the workflow was created without custom labels.
id: GUID.
Response 200: single workflow object, same shape as above.
Response 403: If you don't have access to a workflow, you'll receive an access error. The same error is returned if the workflow doesn't exist at all — so you won't be able to tell the difference between the two. If your key is linked to an admin user, the access check is bypassed, and you'll receive a clearer "not found" error when a workflow ID doesn't exist.
Requires a Read & write key, and the caller must be a Workflow Admin. The fields below are the only ones this endpoint can change; other workflow settings (image, terminology, workspace) aren't writable through this API.
Body (all optional)
{
"name": "PPMS Renamed",
"color": "#16a34a",
"visibility": false
}
Response 204 on success. Note: unlike GET, existence is checked before the admin check here, so a nonexistent id always returns 404, even for a caller who wouldn't otherwise be allowed to see it.
Response 403: Read-only key, or caller isn't an admin on this workflow. Both cases return 403 but with different messages.
Response 404: workflow doesn't exist.