ENentire
Project Agents

Save a project agent

Changed on

Saving runs, schedules and dispatches nothing. Reuse the Idempotency-Key with the same body to retry; a changed body needs a new key.

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

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
  • Auth
    none declared. Required headers: Idempotency-Key

Path parameters

forge'gh' | 'et' required
projectstring required

Headers

Idempotency-Keystring required

Request body

presetstring nullable

Run an Entire preset as it is now; omit or send null for a custom agent.

namestring

Required without a preset.

descriptionstring
is_enabledboolean
harness'claude' | 'codex'
modelstring nullable
reasoning_effort'low' | 'medium' | 'high' | 'xhigh' | 'max' | 'ultra' nullable
timeout_msinteger
instructionsstring
repository_idsstring[] required
environment_idstring

Response

Saved, or replayed from an earlier request with the same key

idstring required
project_idstring required
versioninteger required
etagstring required

Write token: send it unchanged as If-Match to replace or archive.

created_atstring required
updated_atstring required
archived_atstring nullable required
namestring required
descriptionstring required
harnessstring required
modelstring nullable required
reasoning_effortstring nullable required
timeout_msinteger required
instructionsstring required
is_enabledboolean required

Whether its trigger runs it. A paused agent still runs when asked to.

environment_idstring required
repository_idsstring[] required
stale_repository_idsstring[] required

Changes

  • 3ff783b497b2Revision changes
    • warning

      removed the request property /

  • f4a534501f84Revision changes
    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status