# Activate a workflow (/docs/api-reference/workflows/activateWorkflow) > Turn the published workflow on, so real events run it. Use it to resume a workflow you paused with `deactivateWorkflow`. > **Workflow builder.** Included from the Jump Starter plan. [See plans](https://omnidim.io/pricing). **POST** `/workflows/{workflow_id}/activate` Turn the published workflow on, so real events run it. Use it to resume a workflow you paused with `deactivateWorkflow`. ```yaml operationId: activateWorkflow parameters: - in: path name: workflow_id required: true schema: type: integer description: Id of the workflow. - in: query name: user_id required: false description: | Reseller keys only: the id of one of your direct client users. The call then acts as that client, on that client's agents, numbers, campaigns and balance. Calls, sessions and bulk campaigns spend that client's balance and concurrency. Omit it to act on your own account. An empty value, `0`, `false` or your own user id also means your own account. Any other value that is not a positive integer id is refused with `400 invalid_request`. A key that is not a reseller's gets `403` when it names someone else. A user who is not your direct client gets `404`. schema: type: integer description: | Reseller keys only: the id of one of your direct client users. The call then acts as that client, on that client's agents, numbers, campaigns and balance. Calls, sessions and bulk campaigns spend that client's balance and concurrency. Omit it to act on your own account. Send it as a JSON integer in the body. `null`, `0`, `false` or your own user id also means your own account. Any other value that is not a positive integer id is refused with `400 invalid_request`. A key that is not a reseller's gets `403` when it names someone else. A user who is not your direct client gets `404`. example: 1234 responses: '200': description: The workflow is active. content: application/json: schema: type: object properties: workflow: type: object properties: id: type: integer name: type: string status: type: string enum: - draft - active - paused description: >- `draft`: never published. `active`: the published version is live. `paused`: published but turned off. published_version_id: type: integer nullable: true webhook_url: type: string nullable: true description: Set when the workflow takes a webhook trigger. draft: type: object description: The editable version of a workflow. nullable: true properties: version_id: type: integer revision: type: string description: >- Send this back in `editWorkflow`. It changes on every edit, including edits made in the dashboard. nodes: type: array items: type: object description: A node as the API shows it. properties: id: type: string type: type: string description: A node type from `listWorkflowNodeTypes`. label: type: string nullable: true position: type: object properties: x: type: number 'y': type: number config: type: object additionalProperties: true description: | Only in `view=full`. The node's settings. The fields for each node type come from `getWorkflowNodeType`. Secrets read back as `********`. edges: type: array items: type: object properties: from: type: string description: Id of the node the edge starts at. to: type: string description: Id of the node the edge ends at. handle: type: string description: The output of the `from` node. `default` for a plain edge. '400': description: >- A bad parameter or body. `code` says which, such as `invalid_json`, `invalid_parameter`, `missing_fields` or `no_options`. content: application/json: schema: type: object description: | The v1 error envelope. Some errors add keys: `errors` (validation issues), `op_index` and `hint` (a refused op), `revision` (the current revision after a conflict). properties: error: type: string description: Machine-readable error code, such as `revision_conflict`. error_description: type: string description: Human-readable explanation. code: type: string description: Stable, specific reason. Present on 400 errors and auth errors. request_id: type: string description: >- Correlates this response with the server log. Also sent as the `X-Request-Id` header. errors: type: array description: On `validation_failed`, the issues that blocked the request. items: type: object description: One problem found in a draft. properties: code: type: string description: > Stable issue code. `not_found`: an id is not in this workspace, pick one with `listWorkflowFieldOptions`. `templated_ref`: an id field holds a `{{ }}` template; ids must be literal. Others include `missing_field`, `bad_option`, `bad_handle`, `unreachable`, `trigger_count`, `unknown_type`, `unknown_reference` and `malformed`. message: type: string node: type: string nullable: true description: Id of the node the issue is about, if any. field: type: string nullable: true description: Config field the issue is about, if any. hint: type: string nullable: true description: What to do to fix it. op_index: type: integer description: On `invalid_op`, the zero-based position of the op that failed. hint: type: string description: On `invalid_op`, what to do next. revision: type: string description: On `revision_conflict`, the current revision of the draft. example: error: invalid_request error_description: revision is required. Read the workflow to get it. code: missing_fields request_id: req_5d9a1f3e8b02 '401': description: Missing or invalid API key. content: application/json: schema: type: object description: | The v1 error envelope. Some errors add keys: `errors` (validation issues), `op_index` and `hint` (a refused op), `revision` (the current revision after a conflict). properties: error: type: string description: Machine-readable error code, such as `revision_conflict`. error_description: type: string description: Human-readable explanation. code: type: string description: Stable, specific reason. Present on 400 errors and auth errors. request_id: type: string description: >- Correlates this response with the server log. Also sent as the `X-Request-Id` header. errors: type: array description: On `validation_failed`, the issues that blocked the request. items: type: object description: One problem found in a draft. properties: code: type: string description: > Stable issue code. `not_found`: an id is not in this workspace, pick one with `listWorkflowFieldOptions`. `templated_ref`: an id field holds a `{{ }}` template; ids must be literal. Others include `missing_field`, `bad_option`, `bad_handle`, `unreachable`, `trigger_count`, `unknown_type`, `unknown_reference` and `malformed`. message: type: string node: type: string nullable: true description: Id of the node the issue is about, if any. field: type: string nullable: true description: Config field the issue is about, if any. hint: type: string nullable: true description: What to do to fix it. op_index: type: integer description: On `invalid_op`, the zero-based position of the op that failed. hint: type: string description: On `invalid_op`, what to do next. revision: type: string description: On `revision_conflict`, the current revision of the draft. example: error: unauthorized error_description: Missing or invalid API key code: invalid_api_key request_id: req_6e2b9d4f1a38 '403': description: | The Workflow Builder is not enabled for this account (`feature_not_enabled`), or your API key's user cannot make this change (`permission_denied`). The Workflow Builder must be included in your plan. content: application/json: schema: type: object description: | The v1 error envelope. Some errors add keys: `errors` (validation issues), `op_index` and `hint` (a refused op), `revision` (the current revision after a conflict). properties: error: type: string description: Machine-readable error code, such as `revision_conflict`. error_description: type: string description: Human-readable explanation. code: type: string description: Stable, specific reason. Present on 400 errors and auth errors. request_id: type: string description: >- Correlates this response with the server log. Also sent as the `X-Request-Id` header. errors: type: array description: On `validation_failed`, the issues that blocked the request. items: type: object description: One problem found in a draft. properties: code: type: string description: > Stable issue code. `not_found`: an id is not in this workspace, pick one with `listWorkflowFieldOptions`. `templated_ref`: an id field holds a `{{ }}` template; ids must be literal. Others include `missing_field`, `bad_option`, `bad_handle`, `unreachable`, `trigger_count`, `unknown_type`, `unknown_reference` and `malformed`. message: type: string node: type: string nullable: true description: Id of the node the issue is about, if any. field: type: string nullable: true description: Config field the issue is about, if any. hint: type: string nullable: true description: What to do to fix it. op_index: type: integer description: On `invalid_op`, the zero-based position of the op that failed. hint: type: string description: On `invalid_op`, what to do next. revision: type: string description: On `revision_conflict`, the current revision of the draft. example: error: forbidden error_description: You do not have permission to use Workflows. code: feature_not_enabled request_id: req_9f2c1a4b7d3e '404': description: No workflow, node type or run with that id in your account. content: application/json: schema: type: object description: | The v1 error envelope. Some errors add keys: `errors` (validation issues), `op_index` and `hint` (a refused op), `revision` (the current revision after a conflict). properties: error: type: string description: Machine-readable error code, such as `revision_conflict`. error_description: type: string description: Human-readable explanation. code: type: string description: Stable, specific reason. Present on 400 errors and auth errors. request_id: type: string description: >- Correlates this response with the server log. Also sent as the `X-Request-Id` header. errors: type: array description: On `validation_failed`, the issues that blocked the request. items: type: object description: One problem found in a draft. properties: code: type: string description: > Stable issue code. `not_found`: an id is not in this workspace, pick one with `listWorkflowFieldOptions`. `templated_ref`: an id field holds a `{{ }}` template; ids must be literal. Others include `missing_field`, `bad_option`, `bad_handle`, `unreachable`, `trigger_count`, `unknown_type`, `unknown_reference` and `malformed`. message: type: string node: type: string nullable: true description: Id of the node the issue is about, if any. field: type: string nullable: true description: Config field the issue is about, if any. hint: type: string nullable: true description: What to do to fix it. op_index: type: integer description: On `invalid_op`, the zero-based position of the op that failed. hint: type: string description: On `invalid_op`, what to do next. revision: type: string description: On `revision_conflict`, the current revision of the draft. example: error: not_found error_description: No workflow with that id. request_id: req_2c8e7a1d9b40 '409': description: '`not_published`: publish the workflow first.' content: application/json: schema: type: object description: | The v1 error envelope. Some errors add keys: `errors` (validation issues), `op_index` and `hint` (a refused op), `revision` (the current revision after a conflict). properties: error: type: string description: Machine-readable error code, such as `revision_conflict`. error_description: type: string description: Human-readable explanation. code: type: string description: Stable, specific reason. Present on 400 errors and auth errors. request_id: type: string description: >- Correlates this response with the server log. Also sent as the `X-Request-Id` header. errors: type: array description: On `validation_failed`, the issues that blocked the request. items: type: object description: One problem found in a draft. properties: code: type: string description: > Stable issue code. `not_found`: an id is not in this workspace, pick one with `listWorkflowFieldOptions`. `templated_ref`: an id field holds a `{{ }}` template; ids must be literal. Others include `missing_field`, `bad_option`, `bad_handle`, `unreachable`, `trigger_count`, `unknown_type`, `unknown_reference` and `malformed`. message: type: string node: type: string nullable: true description: Id of the node the issue is about, if any. field: type: string nullable: true description: Config field the issue is about, if any. hint: type: string nullable: true description: What to do to fix it. op_index: type: integer description: On `invalid_op`, the zero-based position of the op that failed. hint: type: string description: On `invalid_op`, what to do next. revision: type: string description: On `revision_conflict`, the current revision of the draft. ``` **curl** ```bash curl -X POST "https://backend.omnidim.io/api/v1/workflows/{workflow_id}/activate?user_id=1234" \ -H "Authorization: Bearer $OMNIDIM_API_KEY" ```