Associate an existing check with a target without running or approving it
POST
/v1/quality/targets/{targetType}/{targetId}/checksRequires target edit access, check evidence read access and agents write permission. Current permissions are rechecked on retries. The organization/target/check tuple is the idempotency identity. Execution-dispatch credentials cannot change Quality setup. The relation is a declared association, not verified execution lineage.
How to call this endpoint
Every ACP API request uses bearer authentication. The examples here show the actual request path, auth header, and body shape that the platform expects.
Path, query, and header parameters
These parameters control which ACP object the endpoint acts on and how the request is processed.
Path parameters
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| targetType | path | metronome | function | agent | Yes | — |
| targetId | path | string | Yes | — |
Query parameters
None.
Body schema
Content type: application/json · Required
| Field | Type | Required | Description |
|---|---|---|---|
| checkKind | assertion | benchmark | Yes | — |
| checkId | string | Yes | — |
What the API returns
Each response code below includes the documented payload shape for the ACP API.
200Retained association or identical retry; no check or target executionapplication/json
| Field | Type | Required | Description |
|---|---|---|---|
| association | object | Yes | — |
| association.id | string | Yes | Unique identifier. |
| association.targetType | metronome | function | agent | Yes | — |
| association.targetId | string | Yes | — |
| association.checkKind | assertion | benchmark | Yes | — |
| association.checkId | string | Yes | — |
| association.provenance | declared_association | Yes | — |
| association.createdAt | string | Yes | ISO 8601 timestamp. |
400Invalid definition or unknown fields
None.
401Authentication required
None.
403Organization
None.
404Target edit or check evidence permission unavailable
None.
409Association could not be retained
None.
503Durable Quality setup unavailable; retry the same association
None.
Associate an existing check with a target without running or approving it
Loading...
Response 200
Loading...