Skip to main content
POST
Upload an agent

Authorizations

Authorization
string
header
required

Session JWT. After nasiko auth login, print it with jq -r '.clusters[.active].token' ~/.nasiko/config.json. API keys aren't supported.

Body

multipart/form-data

Multipart form for POST /agents/upload — a .zip source/file field (an AgentCard.json + Dockerfile package) plus agent metadata fields.

name
string
required
source
file
required
env
string | null

JSON object of extra env vars, e.g. {"FOO":"bar"}.

hitl
string | null

"true"/"false" — human-in-the-loop approval for a coding agent's tool use. Tri-state like writable: omit to take the default for the kind on a new agent (ON for acp_coding_agent, OFF otherwise) and to keep an existing agent's stored setting — the CLI only sends it when --hitl/--no-hitl was passed.

inbound_format
string | null

openai (default) | anthropic | gemini — which SDK the agent's code speaks.

parking_policy
string | null

auto (default: the platform parks the agent when idle) | resident (always running). Omit to keep an existing agent's stored policy.

ports
string | null

Comma-separated container ports (defaults to 8000).

version_tag
string | null
workload_kind
string | null

agent (default) | mcp_connector | acp_coding_agent — the workload kind. acp_coding_agent registers an ACP coding agent, deployed port-less and driven over a stdio turn. Tri-state like writable: omit to keep an existing agent's stored kind (agent for a new agent) — the CLI only sends it when --coding-agent (or an AgentCard workloadKind) applies.

writable
string | null

"true"/"false" to mount / not mount a persistent, private-per-agent directory at /workspace. Tri-state: omit the field to keep an existing agent's stored setting (false for a new agent) — the CLI only sends it when --writable was passed.

writable_path
string | null

Container-side mount target for the writable volume (--writable-path). Absolute path; implies writable. Omit to keep an existing agent's stored path (/workspace for a new agent).

Response

Build queued

data
object
required
message
string
required
status_code
integer<int32>
required
Required range: x >= 0