Endpoints
DEVELOPER REFERENCE

Deploy workflow

POST /workflows/{workflowId}/deploy

Set a draft workflow to deployed and resume eligible paused schedules. Already-deployed workflows return 422. Validate configuration before deploying.

POST /api/v1/workflows/{workflowId}/deploy

Permission: workflows:write. Write endpoints also require a workspace role that permits changes. See authentication and errors.

With API-key authentication, this endpoint does not replay Idempotency-Key receipts. MCP OAuth contract calls have separate transaction semantics; see the authoring guide.

Request

curl --request POST 'https://app.innflow.ai/api/v1/workflows/workflow_id/deploy' \
  --header "Authorization: Bearer $INNFLOW_API_KEY"

Examples use placeholder IDs. Set INNFLOW_API_KEY in your shell and replace IDs with your own before sending a request.

Parameters

NameInRequiredDetails
workflowIdpathYesResource identifier.
X-Innflow-WorkspaceheaderNoOrganization ID, or personal. Set explicitly; omission uses legacy user-owned resource scope.

Response

HTTP 200 — Returns data with id, name, icon, iconColor, deploymentStatus, deployedAt, createdAt and updatedAt.

See OpenAPI download for the machine-readable request contract and errors for errors and retry behavior.

On this page