Delete Workflow

Delete contract flow

Permanently deletes a contract flow. Returns 404 if it does not exist,
and 400 if it is linked to any contract request.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Permanently deletes a contract flow belonging to your client, regardless of its status. This is irreversible. The only thing that blocks deletion is being linked to an existing contract request; archive such a flow instead with Archive Workflow. On success the endpoint returns no content.

Authentication & access

  • Requires a client API token: Authorization: Bearer <token>.
  • API credentials need the contracts.workflows.archive permission. Dashboard users need the OWNER or OPERATIONS role, or a custom role that includes this permission.
  • Contract signing must be enabled for the client. If it is disabled the request returns 403.

Path parameters

  • workflow_id (string, required) - the ID of the contract flow to delete. It must belong to the authenticated client.

Preconditions

  • The flow must not be linked to any contract requests. If at least one contract request references it, deletion is rejected with 400. Archive the flow instead to stop new contract requests from using it. The flow's status is not checked, so a published or an archived flow can be deleted.

Response

  • 204 No Content - the contract flow was permanently deleted. The response body is empty.

Error responses

StatusWhen
400The flow is linked to one or more contract requests. Archive it instead
403Contract signing is disabled for the client
404No contract flow with this workflow_id exists under the authenticated client

Standard 401 (authentication), 403 (insufficient permission or role), and 429 (rate limit) responses apply to every endpoint and are documented in the Error reference.

Path Params
string
required
Responses
204

Successful Response

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json