Skip to main content
POST
https://ageneral.ai
/
v1
/
agents
Create agent
curl --request POST \
  --url https://ageneral.ai/v1/agents \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "projectId": "<string>",
  "name": "<string>",
  "guest": "<string>",
  "runtimeProvider": "<string>",
  "guestRuntimeProfile": "<string>",
  "firecracker": {
    "vcpu": 123,
    "memMib": 123,
    "runtimeDataSize": "<string>"
  }
}
'
{
  "name": "<string>",
  "done": true,
  "metadata": {},
  "response": {},
  "error": {}
}

Authorizations

​
Authorization
string
header
required

Session JWT from Ageneral sign-in. Send as Authorization: Bearer <token>.

Body

application/json
​
projectId
string
required
​
name
string
​
guest
string
​
runtimeProvider
string
​
guestRuntimeProfile
string

Catalog workload key (for example openclaw) resolved to a pinned fc-guest image.

​
firecracker
object

Optional per-agent Firecracker overrides.

Response

Long-running operation (often completes immediately with done: true).

Subset of google.longrunning.Operation.

​
name
string
​
done
boolean
​
metadata
object
​
response
object
​
error
object