Skip to main content
POST
Provision a principal, actor, and first public key

Authorizations

X-Ambient-Actor
string
header
required

Provisioned actor identifier.

X-Ambient-Timestamp
string
header
required

Current Unix timestamp in seconds, within the configured clock-skew window.

Authorization
string
header
required

Ambient-HMAC followed by a space and the unpadded base64url HMAC-SHA256 signature. See Authentication and authority for the canonical input.

Body

application/json
commandId
string
required

Actor-scoped idempotency key. Retry the identical command with the same value.

Minimum string length: 1
principalId
string
required
Minimum string length: 1
actorId
string
required
Minimum string length: 1
keyId
string
required
Minimum string length: 1
publicKey
string
required

Unpadded base64url encoding of a 32-byte Ed25519 public key.

Required string length: 43

Response

Identity material provisioned or an identical command replayed.

principal
object
required
actor
object
required
key
object
required