Skip to main content
Three endpoints: list agents on a GPU node, deploy an agent to a node, and list every agent in the cluster.

List agents on a node

GET /v1/gpu-nodes/:id/agents Authorization: Bearer API key required.

Path parameters

string
required
GPU node identifier, e.g. gn_a1b2c3d4.

Response

array
required
Array of Agent objects for this node.

Example

Deploy an agent to a node

POST /v1/gpu-nodes/:id/agents Authorization: Bearer API key required.

Path parameters

string
required
GPU node identifier.

Request body

string
Agent name (optional, defaults to agent-).

Response

integer
Response code (0 for success).
object
required
The deployed Agent object.
string
Empty on success.

Example

List all agents globally

GET /v1/agents Authorization: Bearer API key required.

Response

array
required
Array of all Agent objects across nodes.

Example