Agents

Worker self-report of credential readiness (Phase 3 boot loop)

put/api/agents/{id}/credential-status

Path parameters

idstring required

Headers

X-Runtime-Instance-IDstring

Identifies the concrete runtime instance (worker process) making the call, as generated at its boot. Required to report credential readiness when multi-runtime mode (MULTI_RUNTIME_ENABLED) is on; ignored otherwise.

Identifies the concrete runtime instance (worker process) making the call, as generated at its boot. Required to report credential readiness when multi-runtime mode (MULTI_RUNTIME_ENABLED) is on; ignored otherwise.

Request body

readyboolean
missingstring[] nullable

Response

State updated; returns the agent row.

idstring required
namestring required
isLeadboolean
status'idle' | 'busy' | 'offline' | 'waiting_for_credentials' required
descriptionstring
rolestring
capabilitiesstring[]
claudeMdstring
soulMdstring
identityMdstring
setupScriptstring
toolsMdstring
heartbeatMdstring
maxTasksinteger
emptyPollCountinteger
lastActivityAtstring date-time
provider'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode' | 'acp'
harnessProvider'claude' | 'codex' | 'pi' | 'devin' | 'claude-managed' | 'opencode' | 'acp' | 'null' nullable
credentialMissingstring[] nullable
createdAtstring date-time required
lastUpdatedAtstring date-time required

Changes

Changed in 5 of the 104 revisions of this API.41210

    • added the new acp enum value to the ////////// response property for the response status

      response-property-enum-value-added

    • added the new acp enum value to the //// response property for the response status

      response-property-enum-value-added

    • added the new acp enum value to the //// response property for the response status

      response-property-enum-value-added

    • added the new acp enum value to the request property //////

      request-property-enum-value-added

    • added the new acp enum value to the request property /

      request-property-enum-value-added

    • added the new optional header request parameter X-Runtime-Instance-ID

      new-optional-request-parameter

    • added the non-success response with the status

      response-non-success-status-added

  • 06cac6a7c5bc294See the full diff
    • the request property became not nullable

      request-property-became-not-nullable

    • the request property type changed from object null to no type

      request-property-type-changed

    • removed the request property /

      request-property-removed

    • removed the request property /

      request-property-removed

    • removed the request property /

      request-property-removed

    • removed the request property /

      request-property-removed

    • removed the request property /

      request-property-removed

    • removed the request property /

      request-property-removed

    • removed the request property /

      request-property-removed

    • removed the request property /

      request-property-removed

    • removed the request property /

      request-property-removed

    • added subschema #2 to the request property anyOf list

      request-property-any-of-added

    • the request property became nullable

      request-property-became-nullable

    • added the media type application/json for the response with the status

      response-media-type-added

    • added the media type application/json for the response with the status

      response-media-type-added

    • added the new max enum value to the request property //

      request-property-enum-value-added

    • added the new max enum value to the request property /

      request-property-enum-value-added

    • removed the enum value max of the request property //

      request-property-enum-value-removed

    • removed the enum value max of the request property /

      request-property-enum-value-removed