Skip to main content
POST
Create a draft agent for the Personal key's owner from the intake questionnaire; a T3 or T4 risk tier opens an approval.

Authorizations

Authorization
string
header
required

A Personal key (fmcp_…), bound to the person who created it, or an interactive MCP sign-in that resolves to one. Pass as Authorization: Bearer <key>. It acts for that person, under their role grants narrowed by its scopes; an operation that acts for a person admits only this kind.

Headers

Idempotency-Key
string

1–255 printable ASCII characters (0x21–0x7E, no spaces), scoped to the calling credential. A repeat with the same key and request never runs the write again, a 5xx included: once the operation's permissions pass again it answers the identical status and body of the first response (Idempotent-Replayed: true, also sent as Idempotency-Replayed: true), unless the operation's own replay policy withholds it; a first response that was not stored (over 32 KiB, or carrying a one-time secret) answers its first status with only data.id (Idempotency-Replay-Disclosure: id-only) when it named one; otherwise 409 idempotency_result_unavailable; a repeat while the first is still running is 409 idempotency_key_in_flight, and the same key with a different request is 422 idempotency_key_reuse. Honoured for External App JWTs and platform and Personal keys; an External App's static companion key is not protected.

Required string length: 1 - 255

Body

application/json
agentId
string
required
name
string
required
rung
required
Allowed value: "assistive"
externalIntegrations
string[]
required
fiduciaryFlag
boolean
required
transactionalAuthorityLimitCents
number
required
tier
required
Allowed value: "system"
orgUnitId
string
description
string
purpose
string
identity
object
tags
string[]
modelRef
string
corePrompt
string
constraints
object
fiduciaryDataClasses
string[]

Response

Create a draft agent for the Personal key's owner from the intake questionnaire; a T3 or T4 risk tier opens an approval.

data
object
required
meta
object
required