Endpoints
DEVELOPER REFERENCE

Undeploy workflow

POST /workflows/{workflowId}/undeploy

Return a deployed workflow to draft and pause active schedules. A workflow that is not currently deployed returns 422.

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

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.

Request

curl --request POST 'https://app.innflow.ai/api/v1/workflows/workflow_id/undeploy' \
  --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