Execute Resolution
Execute the resolution pipeline on all pending fields. Returns immediately — poll the run for progress. Requires write scope.
POST
/v1/resolutions/{id}/executeResponse
Response fields
idstringResolution run UUID.
source_run_idstringUUID of the originating job run.
statusstringUpdated run status (typically running).
policy_snapshotobject | nullResolution policy configuration captured at run time.
dialect_snapshotobject | nullDialect configuration captured at run time.
error_messagestring | nullError detail if execution failed immediately.
created_atstringISO 8601 creation timestamp.
updated_atstringISO 8601 last update timestamp.
linksobjectRelated resource URLs (self, results, source_run).
Response
{
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"source_run_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"status": "running",
"policy_snapshot": null,
"dialect_snapshot": null,
"error_message": null,
"created_at": "2024-09-14T10:32:00.000Z",
"updated_at": "2024-09-14T10:36:00.000Z",
"links": {
"self": "/v1/resolutions/a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"results": "/v1/resolutions/a1b2c3d4-e5f6-7890-abcd-ef1234567890/results",
"source_run": "/v1/jobs/b2c3d4e5-f6a7-8901-bcde-f12345678901"
}
}Errors
Error responses
401unauthorizedMissing or invalid API key.
404not_foundResolution run not found or does not belong to your organization.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.