REST API Reference > Cloud Data Integration for PowerCenter (CDI-PC) REST API > Reconciling a domain

Reconciling a domain

Use a PATCH request to reconcile a specified domain in IDMC.

PATCH request

Use the following PATCH request to reconcile a CDI-PC domain:

PATCH /api/v1/domains/{ldoId}/reconcile

Note: The URL paths must include the complete Domain Management Service path for the respective POD. Prefix the request with this path.

Parameters

When you reconcile a domain using a REST API, the request typically includes parameters that identify the domain and provide the necessary information to synchronize its state with a source system.

The following example demonstrates the structure and content of a typical request to reconcile API:

PATCH /api/v1/domains/my-domain-id/reconcile HTTP/1.1
Content-Type: application/json
IDS-SESSION-ID: <your-session-token>

{
"domainAuthInfo": {
"username": "admin",
"password": "secretPassword",
"namespace": "Native"
}
}

The following table describes the header and the path parameter components:

Attribute	Type	Description
IDS-SESSION-ID	String	The IDS-SESSION-ID attribute in the header that holds the session ID value. If the organization uses the session ID authentication type, session-based authentication is used. The session ID expires after 30 minutes of inactivity. A grace period of up to 2 minutes might be included to account for any network or unexpected delays.
ldoId	String	Unique identifier assigned to a Logical Domain Object within an organization. Replace ldoId with the actual ID of the domain you want to reconcile.

Request body

The request body requires a domainAuthInfo object for authentication purposes.

{ "domainAuthInfo": {
"username": "string",
"password": "string",
"namespace": "string"
}
}

The following table describes the fields of domainAuthInfo:

Field	Type	Description
username	String	The username for authenticating access to a specific domain. It identifies the user within the domain's authentication system.
password	String	The corresponding password for the username.
namespace	String	The namespace associated with the domain authentication.

Responses

The following table describes the common responses to the reconcile API request:

Field	Description
200	Success response.
400	Bad request. Can be a field or format issue, such as an invalid character or incorrect string length.
401	Authentication issue. For example, invalid credentials or invalid session IDs.
500	Internal server error when an unexpected condition is encountered.