Developers

Errors

{
  "error": {
    "code": "INSUFFICIENT_SCOPE",
    "message": "Token lacks required scope: workflows:read.",
    "requestId": "req_...",
    "apiVersion": "2026-07-01",
    "details": {
      "requiredScope": "workflows:read"
    }
  }
}

Code	HTTP	Meaning	Retry	What to do
`UNAUTHORIZED`	401	Missing, malformed, expired, or invalid API token.	No	Check the Authorization bearer token.
`INSUFFICIENT_SCOPE`	403	Token lacks the required API scope.	No	Create a token with the required scope.
`RATE_LIMITED`	429	A token, route, organization, or IP bucket is over limit.	Yes	Wait for Retry-After or FinkMesh-RateLimit-Reset.
`INVALID_CURSOR`	400	Pagination cursor cannot be decoded.	No	Restart the list request without the cursor.
`INVALID_JSON`	400	Request body is not valid JSON.	No	Send a JSON object with Content-Type: application/json.
`INVALID_TRIGGER_DATA`	400	Run trigger data is invalid.	No	Validate the request body against the endpoint docs.
`IDEMPOTENCY_KEY_REQUIRED`	400	A public write is missing Idempotency-Key.	No	Send a unique key for each logical write.
`IDEMPOTENCY_KEY_CONFLICT`	409	The same key was reused with a different body.	No	Use a new key or replay the exact original request.
`READINESS_BLOCKED`	409	Workflow cannot run or publish yet.	No	Inspect error.details.readiness and fix blockers.
`PLAN_LIMIT_REACHED`	402	Plan quota or entitlement blocks the action.	No	Upgrade or reduce usage.
`PLAN_ENTITLEMENT_REQUIRED`	402	The plan does not include this feature.	No	Upgrade to a plan with the entitlement.
`RUN_QUOTA_EXCEEDED`	429	Monthly run quota is exhausted.	No	Wait for reset or upgrade.
`HTTP_TEST_LIMIT_EXCEEDED`	429	Live HTTP test-run limit is exhausted.	No	Wait for reset or upgrade.
`FAILURE_STORM`	429	Workflow is blocked by failure guardrails.	No	Do not retry automatically. An operator should inspect recent failures and resume when fixed.
`CONCURRENCY_LIMIT_EXCEEDED`	429	Too many active runs are already queued or running.	Yes	Retry later with backoff.
`ENQUEUE_FAILED`	500	Run row was created but could not be queued.	Yes	Retry with a new idempotency key after checking status.
`WORKSPACE_NOT_FOUND`	404	Token workspace no longer exists.	No	Create a token for an active workspace.
`WORKFLOW_NOT_FOUND`	404	Workflow id is unknown or outside the token workspace.	No	Check the workflow id.
`RUN_NOT_FOUND`	404	Run id is unknown or outside the token workspace.	No	Check the run id.
`CONNECTION_NOT_FOUND`	404	Connection id is unknown or outside the token workspace.	No	Check the connection id.
`WEBHOOK_ENDPOINT_NOT_FOUND`	404	Outbound webhook endpoint is missing or deleted.	No	Refresh endpoint metadata.
`WEBHOOK_DELIVERY_NOT_FOUND`	404	Outbound webhook delivery is missing.	No	Refresh delivery history.
`INVALID_WEBHOOK_URL`	422	Webhook URL is missing, not HTTPS, private, or otherwise invalid.	No	Use a public HTTPS receiver URL.
`INVALID_WEBHOOK_EVENTS`	422	Webhook event list contains unsupported values.	No	Use documented event types.
`INVALID_WEBHOOK_STATUS`	422	Webhook status is not active or disabled.	No	Send a supported status value.
`SUPPORT_TICKET_NOT_FOUND`	404	Support ticket is missing or outside the token workspace.	No	Check the ticket id.
`INTERNAL_ERROR`	500	Unexpected server error.	Yes	Retry with backoff and include requestId in support tickets.