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

# POST /v1/{+name}:promote

`POST /v1/{+name}:promote`

Promote a migration job, stopping replication to the destination and promoting the destination to be a standalone database.

## Path parameters

- `name` string, required

## Request body

- PromoteMigrationJobRequest — Request message for 'PromoteMigrationJob' request.
  - `objectsFilter` MigrationJobObjectsConfig — Configuration for the objects to be migrated.
    - `sourceObjectsConfig` SourceObjectsConfig — List of configurations for the source objects to be migrated.
      - `objectsSelectionType` 'OBJECTS_SELECTION_TYPE_UNSPECIFIED' | 'ALL_OBJECTS' | 'SPECIFIED_OBJECTS' — Optional. The objects selection type of the migration job.
      - `objectConfigs` SourceObjectConfig[] — Optional. The list of the objects to be migrated.
        - `objectIdentifier` SourceObjectIdentifier — An identifier for the Migration Job Object.
          - `database` string — Optional. The database name. This will be required only if the object uses a database name as part of its unique identifier.
          - `table` string — Optional. The table name. This will be required only if the object is a level below database or schema.
          - `type` 'MIGRATION_JOB_OBJECT_TYPE_UNSPECIFIED' | 'DATABASE' | 'SCHEMA' | 'TABLE' — Required. The type of the migration job object.
          - `schema` string — Optional. The schema name. This will be required only if the object uses a schema name as part of its unique identifier.

## Response `200`

Successful response

---

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