Skip to main content
This page covers three endpoints: listing agents on a specific GPU node, deploying a new agent to a node, and viewing the global agent list across 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