---
title: "Synchronize metadata for a Database asset"
method: POST
path: "/databases/{databaseId}/synchronizeMetadata"
tags: ["Metadata"]
---

# Synchronize metadata for a Database asset

`POST /databases/{databaseId}/synchronizeMetadata`

Triggers the database synchronization job for a list of schema connections.

This API executes the metadata synchronization as an *asynchronous job* and returns the job ID of the triggered
job in the response.

To monitor the status of a job, use the Jobs resource of the REST Core API: GET /jobs/{jobId}.

## Path parameters

- `databaseId` string, uuid, required

## Request body

- DatabaseMetadataSynchronizationRequest
  - `schemaConnectionIds` string[] — The list of the schemas identified by the schema connection ID for which you want to synchronize metadata. If left empty all schemas with rules defined are synchronized.

## Response `202`

The database metadata synchronization job has started.

- Job
  - `id` string, uuid, required
  - `createdBy` string, uuid, required
  - `createdOn` string, date-time, required
  - `startDate` string, date-time, required
  - `endDate` string, date-time
  - `status` 'Waiting' | 'Running' | 'Completed' | 'Failed', required
  - `report` object

## Other responses

- `400` — The request is not valid.
- `401` — The client is not authenticated.
- `403` — The user lacks permissions.
- `404` — Resource not found.
- `409` — Conflict.

---

[API](https://skmtc.net/collibra/apis/collibra-data-governance-center-core-api.md) · [All operations](https://skmtc.net/collibra/apis/collibra-data-governance-center-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/collibra/collibra-data-governance-center-core-api/revisions/6d091bc86a33/schema)