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

# POST /v1/{+parent}/workflowInvocations

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

Creates a new WorkflowInvocation in a given Repository.

## Path parameters

- `parent` string, required

## Request body

- WorkflowInvocation — Represents a single invocation of a compilation result.
  - `invocationTiming` Interval — Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive). The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time.
    - `startTime` string, google-datetime — Optional. Inclusive start of the interval. If specified, a Timestamp matching this interval will have to be the same or after the start.
    - `endTime` string, google-datetime — Optional. Exclusive end of the interval. If specified, a Timestamp matching this interval will have to be before the end.
  - `resolvedCompilationResult` string — Output only. The resolved compilation result that was used to create this invocation. Will be in the format `projects/*/locations/*/repositories/*/compilationResults/*`.
  - `dataEncryptionState` DataEncryptionState — Describes encryption state of a resource.
    - `kmsKeyVersionName` string — Required. The KMS key version name with which data of a resource is encrypted.
  - `workflowConfig` string — Immutable. The name of the workflow config to invoke. Must be in the format `projects/*/locations/*/repositories/*/workflowConfigs/*`.
  - `internalMetadata` string — Output only. All the metadata information that is used internally to serve the resource. For example: timestamps, flags, status fields, etc. The format of this field is a JSON string.
  - `compilationResult` string — Immutable. The name of the compilation result to use for this invocation. Must be in the format `projects/*/locations/*/repositories/*/compilationResults/*`.
  - `name` string — Output only. The workflow invocation's name.
  - `state` 'STATE_UNSPECIFIED' | 'RUNNING' | 'SUCCEEDED' | 'CANCELLED' | 'FAILED' | 'CANCELING' — Output only. This workflow invocation's current state.
  - `invocationConfig` InvocationConfig — Includes various configuration options for a workflow invocation. If both `included_targets` and `included_tags` are unset, all actions will be included.
    - `serviceAccount` string — Optional. The service account to run workflow invocations under.
    - `queryPriority` 'QUERY_PRIORITY_UNSPECIFIED' | 'INTERACTIVE' | 'BATCH' — Optional. Specifies the priority for query execution in BigQuery. More information can be found at https://cloud.google.com/bigquery/docs/running-queries#queries.
    - `includedTags` string[] — Optional. The set of tags to include.
    - `transitiveDependenciesIncluded` boolean — Optional. When set to true, transitive dependencies of included actions will be executed.
    - `transitiveDependentsIncluded` boolean — Optional. When set to true, transitive dependents of included actions will be executed.
    - `fullyRefreshIncrementalTablesEnabled` boolean — Optional. When set to true, any incremental tables will be fully refreshed.
    - `includedTargets` Target[] — Optional. The set of action identifiers to include.
      - `name` string — Optional. The action's name, within `database` and `schema`.
      - `schema` string — Optional. The action's schema (BigQuery dataset ID), within `database`.
      - `database` string — Optional. The action's database (Google Cloud project ID) .
  - `privateResourceMetadata` PrivateResourceMetadata — Metadata used to identify if a resource is user scoped.
    - `userScoped` boolean — Output only. If true, this resource is user-scoped, meaning it is either a workspace or sourced from a workspace.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/dataform.md) · [All operations](https://skmtc.net/google/apis/dataform/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/dataform/versions/b9dafc69d5c5/schema)