Agents

Create and provision an agent

Create a new agent in the caller's org and start provisioning.

Returns 201 with the pending agent record; provisioning (Proxmox container, WireGuard, SSH) then runs in a background task. Poll GET /agents/{id} to track provisioning status (pending → provisioning → running). Requires owner or admin role.

post/agents

Request

  • Base URL: https://api-docs.jackhamr.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api-docs.jackhamr.ai/agents
  • Auth: none declared

Request body

namestring required
descriptionstring nullable
template_idstring nullable
os_templatestring nullable
coresinteger
memoryinteger
disk_sizeinteger
hostnamestring nullable
tagsobject nullable
avatar_idinteger nullable
subtitlestring nullable
size_preset_idstring nullable

Response

Successful Response

idstring required
organization_idstring required
namestring required
descriptionstring nullable
statusstring required
owner_user_idstring nullable
allow_cloningboolean
visible_to_orgboolean
coresinteger nullable
memoryinteger nullable
disk_sizeinteger nullable
template_idstring nullable
os_templatestring nullable
size_preset_idstring nullable
sort_orderinteger
is_board_cloneboolean
clone_of_agent_idstring nullable
avatar_image_urlstring nullable
avatar_colorstring nullable
subtitlestring nullable
tagsobject nullable
metadataobject nullable
subagent_max_iterationsinteger nullable
error_messagestring nullable
last_error_atstring date-time nullable
created_atstring date-time required
updated_atstring date-time required
provisioned_atstring date-time nullable
started_atstring date-time nullable
stopped_atstring date-time nullable
hibernated_atstring date-time nullable

Changes

No recorded changes to this operation across all 1 revision of this API.