Claim durable evaluation or optimization execution

POST/v1/internal/execution-dispatch/claims

Internal platform-worker endpoint. Claims are leased with FOR UPDATE SKIP LOCKED semantics and return a one-time, short-lived workload credential. Both the claim lease and resource execution lease fence duplicate execution.

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

None.

Query parameters

None.

Body schema

Content type: application/json · Optional

Field	Type	Required	Description
kinds	evaluation_run \| agent_optimization[]	No	—
limit	integer	No	—
leaseTtlMs	integer	No	—

What the API returns

Each response code below includes the documented payload shape for the ACP API.

200Leased execution claimsapplication/json

Field	Type	Required	Description
object	list	Yes	—
data	object[]	Yes	—
data[].dispatch	object	Yes	—
data[].dispatch.id	string	Yes	Unique identifier.
data[].dispatch.kind	evaluation_run \| test_run \| agent_optimization	Yes	—
data[].dispatch.resourceId	string	Yes	—
data[].dispatch.parentResourceId	string	No	—
data[].dispatch.userId	string	No	User ID.
data[].dispatch.organizationId	string	No	—
data[].dispatch.status	queued \| leased \| retry_wait \| completed \| cancelled \| dead_letter	Yes	Current lifecycle status.
data[].dispatch.reason	string	Yes	—
data[].dispatch.priority	integer	Yes	—
data[].dispatch.attemptCount	integer	Yes	—
data[].dispatch.maxAttempts	integer	Yes	—
data[].dispatch.availableAt	string	Yes	—
data[].dispatch.claimOwner	string	No	—
data[].dispatch.claimExpiresAt	string	No	—
data[].dispatch.heartbeatAt	string	No	—
data[].dispatch.credentialId	string	No	—
data[].dispatch.lastError	string	No	—
data[].dispatch.lastErrorClassification	transient \| permanent	No	—
data[].dispatch.createdAt	string	Yes	ISO 8601 timestamp.
data[].dispatch.updatedAt	string	Yes	ISO 8601 timestamp.
data[].dispatch.completedAt	string	No	ISO 8601 timestamp.
data[].dispatch.deadLetteredAt	string	No	—
data[].dispatch.metadata	object	Yes	Free-form metadata object.
data[].lease	object	Yes	—
data[].lease.token	string	Yes	One-time opaque claim token. Never persist or log.
data[].lease.expiresAt	string	Yes	—
data[].credential	object	Yes	—
data[].credential.id	string	Yes	Unique identifier.
data[].credential.key	string	Yes	One-time lease-bound workload key. Never persist or log.
data[].credential.expiresAt	string	Yes	—
claims	object[]	Yes	—
claims[].dispatch	object	Yes	—
claims[].dispatch.id	string	Yes	Unique identifier.
claims[].dispatch.kind	evaluation_run \| test_run \| agent_optimization	Yes	—
claims[].dispatch.resourceId	string	Yes	—
claims[].dispatch.parentResourceId	string	No	—
claims[].dispatch.userId	string	No	User ID.
claims[].dispatch.organizationId	string	No	—
claims[].dispatch.status	queued \| leased \| retry_wait \| completed \| cancelled \| dead_letter	Yes	Current lifecycle status.
claims[].dispatch.reason	string	Yes	—
claims[].dispatch.priority	integer	Yes	—
claims[].dispatch.attemptCount	integer	Yes	—
claims[].dispatch.maxAttempts	integer	Yes	—
claims[].dispatch.availableAt	string	Yes	—
claims[].dispatch.claimOwner	string	No	—
claims[].dispatch.claimExpiresAt	string	No	—
claims[].dispatch.heartbeatAt	string	No	—
claims[].dispatch.credentialId	string	No	—
claims[].dispatch.lastError	string	No	—
claims[].dispatch.lastErrorClassification	transient \| permanent	No	—
claims[].dispatch.createdAt	string	Yes	ISO 8601 timestamp.
claims[].dispatch.updatedAt	string	Yes	ISO 8601 timestamp.
claims[].dispatch.completedAt	string	No	ISO 8601 timestamp.
claims[].dispatch.deadLetteredAt	string	No	—
claims[].dispatch.metadata	object	Yes	Free-form metadata object.
claims[].lease	object	Yes	—
claims[].lease.token	string	Yes	One-time opaque claim token. Never persist or log.
claims[].lease.expiresAt	string	Yes	—
claims[].credential	object	Yes	—
claims[].credential.id	string	Yes	Unique identifier.
claims[].credential.key	string	Yes	One-time lease-bound workload key. Never persist or log.
claims[].credential.expiresAt	string	Yes	—

401Worker assertion required

None.

403Worker assertion invalid or expired

None.

503Durable dispatch is unavailable

None.

Claim durable evaluation or optimization execution

Response 200

See the ACP quickstart and SDK flow