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

# POST /v1/{+parent}/compilationResults

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

Creates a new CompilationResult in a given project and location.

## Path parameters

- `parent` string, required

## Request body

- CompilationResult — Represents the result of compiling a Dataform project.
  - `gitCommitish` string — Immutable. Git commit/tag/branch name at which the repository should be compiled. Must exist in the remote repository. Examples: - a commit SHA: `12ade345` - a tag: `tag1` - a branch name: `branch1`
  - `releaseConfig` string — Immutable. The name of the release config to compile. Must be in the format `projects/*/locations/*/repositories/*/releaseConfigs/*`.
  - `compilationErrors` CompilationError[] — Output only. Errors encountered during project compilation.
    - `stack` string — Output only. The error's full stack trace.
    - `message` string — Output only. The error's top level message.
    - `path` string — Output only. The path of the file where this error occurred, if available, relative to the project root.
    - `actionTarget` Target — Represents an action identifier. If the action writes output, the output will be written to the referenced database object.
      - `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) .
  - `createTime` string, google-datetime — Output only. The timestamp of when the compilation result was created.
  - `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.
  - `workspace` string — Immutable. The name of the workspace to compile. Must be in the format `projects/*/locations/*/repositories/*/workspaces/*`.
  - `name` string — Output only. The compilation result's name.
  - `dataformCoreVersion` string — Output only. The version of `@dataform/core` that was used for compilation.
  - `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.
  - `resolvedGitCommitSha` string — Output only. The fully resolved Git commit SHA of the code that was compiled. Not set for compilation results whose source is a workspace.
  - `dataEncryptionState` DataEncryptionState — Describes encryption state of a resource.
    - `kmsKeyVersionName` string — Required. The KMS key version name with which data of a resource is encrypted.
  - `codeCompilationConfig` CodeCompilationConfig — Configures various aspects of Dataform code compilation.
    - `vars` object — Optional. User-defined variables that are made available to project code during compilation.
    - `assertionSchema` string — Optional. The default schema (BigQuery dataset ID) for assertions.
    - `defaultSchema` string — Optional. The default schema (BigQuery dataset ID).
    - `tablePrefix` string — Optional. The prefix that should be prepended to all table names.
    - `defaultDatabase` string — Optional. The default database (Google Cloud project ID).
    - `defaultLocation` string — Optional. The default BigQuery location to use. Defaults to "US". See the BigQuery docs for a full list of locations: https://cloud.google.com/bigquery/docs/locations.
    - `databaseSuffix` string — Optional. The suffix that should be appended to all database (Google Cloud project ID) names.
    - `schemaSuffix` string — Optional. The suffix that should be appended to all schema (BigQuery dataset ID) names.
    - `builtinAssertionNamePrefix` string — Optional. The prefix to prepend to built-in assertion names.
    - `defaultNotebookRuntimeOptions` NotebookRuntimeOptions — Configures various aspects of Dataform notebook runtime.
      - `gcsOutputBucket` string — Optional. The Google Cloud Storage location to upload the result to. Format: `gs://bucket-name`.
      - `aiPlatformNotebookRuntimeTemplate` string — Optional. The resource name of the [Colab runtime template] (https://cloud.google.com/colab/docs/runtimes), from which a runtime is created for notebook executions. If not specified, a runtime is created with Colab's default specifications.

## 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)