Skip to main content
POST
Provision an agent profile

Authorizations

Authorization
string
header
required

Workspace API key. Create one via the dashboard or POST /v1/auth/keys.

Path Parameters

user_id
string
required

Tenant id, or default/me.

Body

application/json
template
string

Template name (registered via naive.config.ts / naive up).

idempotency_key
string

A retried provision with the same key resumes the same agentProfile.

overrides
object

Overrides applied on top of the template (legalName, comms domain, …).

Response

201 - application/json

Agent profile provisioned

A per-tenant governed real-world agent profile (identity, money, comms, runtime).

id
string
user_id
string
template
string | null
status
enum<string>
Available options:
provisioning,
verifying,
needs_action,
active,
failed,
revoked
needs_action
object | null
resources
object
created_at
string<date-time>