Managed agents

Read an agent deployment

Changed on
get/v1/agents/{id}

Request

  • Base URL
    / (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    HTTP bearer

Path parameters

idstring required

Response

Success

attempt_budget_usdnumber nullable

Fixed attempt reservation from the current accepted revision. Absent for the legacy allocation policy.

idstring required
namestring required
status'active' | 'paused' required
current_revisioninteger required
budget_usdnumber

Deprecated compatibility field. Customer spending limits are not enforced.

cost_usdnumber required
reserved_usdnumber required
min_workersinteger
max_workersinteger
created_atstring date-time
urlstring
queuedinteger

Accepted queued or recovering runs.

assistant_template'nodus:claude-assistant-v1' | 'nodus:claude-assistant-v2'

Qualified built-in assistant from assistant_templates in the managed model catalog. Supplies its installed entrypoint and environment. No project, setup command or provider credential is required.

modelstring

Qualified Messages model accepted for this revision. Provider credentials stay in Nodus.

model_max_output_tokensinteger

Per-call output bound for hosted model access. Omission uses the selected model maximum from the current catalog. An explicit value must fit that model. Accepted revisions retain their resolved limit.

Changes

    • info

      the response's property default value 1024 was removed for the status

    • warning

      added the new nodus:claude-assistant-v2 enum value to the response property for the response status