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

# POST /v1/{+parent}/rollouts

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

Creates a new rollout for a backend.

## Path parameters

- `parent` string, required

## Query parameters

- `requestId` string
- `rolloutId` string
- `validateOnly` boolean

## Request body

- Rollout — A single rollout of a build for a backend.
  - `reconciling` boolean — Output only. A field that, if true, indicates that the Rollout currently has an LRO.
  - `labels` object — Optional. Unstructured key value map that can be used to organize and categorize objects.
  - `error` 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).
    - `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.
    - `code` integer — The status code, which should be an enum value of google.rpc.Code.
    - `details` object[] — A list of messages that carry the error details. There is a common set of message types for APIs to use.
  - `name` string — Identifier. The resource name of the rollout. Format: `projects/{project}/locations/{locationId}/backends/{backendId}/rollouts/{rolloutId}`.
  - `uid` string — Output only. System-assigned, unique identifier.
  - `createTime` string, google-datetime — Output only. Time at which the rollout was created.
  - `updateTime` string, google-datetime — Output only. Time at which the rollout was last updated.
  - `annotations` object — Optional. Unstructured key value map that may be set by external tools to store and arbitrary metadata. They are not queryable and should be preserved when modifying objects.
  - `displayName` string — Optional. Human-readable name. 63 character limit.
  - `deleteTime` string, google-datetime — Output only. Time at which the rollout was deleted.
  - `build` string — Required. Immutable. The name of a build that already exists. It doesn't have to be built; a rollout will wait for a build to be ready before updating traffic.
  - `etag` string — Output only. Server-computed checksum based on other values; may be sent on update or delete to ensure operation is done on expected resource.
  - `state` 'STATE_UNSPECIFIED' | 'QUEUED' | 'PENDING_BUILD' | 'PROGRESSING' | 'PAUSED' | 'SUCCEEDED' | 'FAILED' | 'CANCELLED' | 'SKIPPED' — Output only. The state of the rollout.

## Response `200`

Successful response

---

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