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

# POST /v1/{+parent}/releaseConfigs

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

Creates a new ReleaseConfig in a given Repository.

## Path parameters

- `parent` string, required

## Query parameters

- `releaseConfigId` string

## Request body

- ReleaseConfig — Represents a Dataform release configuration.
  - `gitCommitish` string — Required. 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`
  - `name` string — Identifier. The release config's name.
  - `recentScheduledReleaseRecords` ScheduledReleaseRecord[] — Output only. Records of the 10 most recent scheduled release attempts, ordered in descending order of `release_time`. Updated whenever automatic creation of a compilation result is triggered by cron_schedule.
    - `compilationResult` string — The name of the created compilation result, if one was successfully created. Must be in the format `projects/*/locations/*/repositories/*/compilationResults/*`.
    - `errorStatus` Status — The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).
      - `code` integer — The status code, which should be an enum value of google.rpc.Code.
      - `message` string — A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
      - `details` object[] — A list of messages that carry the error details. There is a common set of message types for APIs to use.
    - `releaseTime` string, google-datetime — Output only. The timestamp of this release attempt.
  - `disabled` boolean — Optional. Disables automatic creation of compilation results.
  - `timeZone` string — Optional. Specifies the time zone to be used when interpreting cron_schedule. Must be a time zone name from the time zone database (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). If left unspecified, the default is UTC.
  - `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.
  - `cronSchedule` string — Optional. Optional schedule (in cron format) for automatic creation of compilation results.
  - `releaseCompilationResult` string — Optional. The name of the currently released compilation result for this release config. This value is updated when a compilation result is automatically created from this release config (using cron_schedule), or when this resource is updated by API call (perhaps to roll back to an earlier release). The compilation result must have been created using this release config. Must be in the format `projects/*/locations/*/repositories/*/compilationResults/*`.
  - `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)