ENentire
Project Agents

Run an agent on a Change

Changed on

Runs the agent's current version on one Change of a Trail in a repository it selects. A paused agent still runs when asked to. Reuse the Idempotency-Key with the same body to retry an ambiguous failure.

post/api/v1/{forge}/{project}/agents/{id}/runs

Request

  • Base URL
    https://entire.io (the document declares no server; this is the origin it was published from)
  • URL
    https://entire.io/api/v1/{forge}/{project}/agents/{id}/runs
  • Auth
    none declared. Required headers: Idempotency-Key

Path parameters

forge'gh' | 'et' required
projectstring required
idstring required

Headers

Idempotency-Keystring required

Request body

head_shastring

Refuse the run (409) if the Change's head is no longer this commit.

Response

Run admitted, or replayed from an earlier identical request

idstring required
project_idstring required
repository_idstring required
status'queued' | 'running' | 'succeeded' | 'failed' | 'timed_out' | 'canceled' required
attemptinteger required
retry_ofstring nullable required
created_atstring required
updated_atstring required
diagnosticstring nullable required
replayedboolean

Changes