---
title: "POST /v1/{+parent}/executions"
method: POST
path: "/v1/{+parent}/executions"
tags: ["projects"]
---

# POST /v1/{+parent}/executions

`POST /v1/{+parent}/executions`

Creates a new execution using the latest revision of the given workflow. For more information, see Execute a workflow.

## Path parameters

- `parent` string, required

## Request body

- Execution — A running instance of a [Workflow](/workflows/docs/reference/rest/v1/projects.locations.workflows).
  - `startTime` string, google-datetime — Output only. Marks the beginning of execution. Note that this will be the same as `createTime` for executions that start immediately.
  - `result` string — Output only. Output of the execution represented as a JSON string. The value can only be present if the execution's state is `SUCCEEDED`.
  - `duration` string, google-duration — Output only. Measures the duration of the execution.
  - `callLogLevel` 'CALL_LOG_LEVEL_UNSPECIFIED' | 'LOG_ALL_CALLS' | 'LOG_ERRORS_ONLY' | 'LOG_NONE' — The call logging level associated to this execution.
  - `executionHistoryLevel` 'EXECUTION_HISTORY_LEVEL_UNSPECIFIED' | 'EXECUTION_HISTORY_BASIC' | 'EXECUTION_HISTORY_DETAILED' — Optional. Describes the execution history level to apply to this execution. If not specified, the execution history level is determined by its workflow's execution history level. If the levels are different, the executionHistoryLevel overrides the workflow's execution history level for this execution.
  - `state` 'STATE_UNSPECIFIED' | 'ACTIVE' | 'SUCCEEDED' | 'FAILED' | 'CANCELLED' | 'UNAVAILABLE' | 'QUEUED' — Output only. Current state of the execution.
  - `disableConcurrencyQuotaOverflowBuffering` boolean — Optional. If set to true, the execution will not be backlogged when the concurrency quota is exhausted. The backlog execution starts when the concurrency quota becomes available.
  - `status` Status — Represents the current status of this execution.
    - `currentSteps` Step[] — A list of currently executing or last executed step names for the workflow execution currently running. If the workflow has succeeded or failed, this is the last attempted or executed step. Presently, if the current step is inside a subworkflow, the list only includes that step. In the future, the list will contain items for each step in the call stack, starting with the outermost step in the `main` subworkflow, and ending with the most deeply nested step.
      - `routine` string — Name of a routine within the workflow.
      - `step` string — Name of a step within the routine.
  - `createTime` string, google-datetime — Output only. Marks the creation of the execution.
  - `argument` string — Input parameters of the execution represented as a JSON string. The size limit is 32KB. *Note*: If you are using the REST API directly to run your workflow, you must escape any JSON string value of `argument`. Example: `'{"argument":"{\"firstName\":\"FIRST\",\"lastName\":\"LAST\"}"}'`
  - `name` string — Output only. The resource name of the execution. Format: projects/{project}/locations/{location}/workflows/{workflow}/executions/{execution}
  - `endTime` string, google-datetime — Output only. Marks the end of execution, successful or not.
  - `workflowRevisionId` string — Output only. Revision of the workflow this execution is using.
  - `stateError` StateError — Describes an error related to the current state of the Execution resource.
    - `details` string — Provides specifics about the error.
    - `type` 'TYPE_UNSPECIFIED' | 'KMS_ERROR' — The type of this state error.
  - `error` Error — Error describes why the execution was abnormally terminated.
    - `payload` string — Error message and data returned represented as a JSON string.
    - `stackTrace` StackTrace — A collection of stack elements (frames) where an error occurred.
      - `elements` StackTraceElement[] — An array of stack elements.
        - `position` Position — Position contains source position information about the stack trace element such as line number, column number and length of the code block in bytes.
          - `line` string, int64 — The source code line number the current instruction was generated from.
          - `column` string, int64 — The source code column position (of the line) the current instruction was generated from.
          - `length` string, int64 — The number of bytes of source code making up this stack trace element.
        - `step` string — The step the error occurred at.
        - `routine` string — The routine where the error occurred.
    - `context` string — Human-readable stack trace string.
  - `labels` object — Labels associated with this execution. Labels can contain at most 64 entries. Keys and values can be no longer than 63 characters and can only contain lowercase letters, numeric characters, underscores, and dashes. Label keys must start with a letter. International characters are allowed. By default, labels are inherited from the workflow but are overridden by any labels associated with the execution.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/workflowexecutions.md) · [All operations](https://skmtc.dev/google/apis/workflowexecutions/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/workflowexecutions/revisions/f7306ae7ff72/schema)