Skip to main content
POST
Issue a fresh key for an agent

Authorizations

Authorization
string
header
required

Either a key (keya_…) or an access token (a JWT) for the audience https://access.noetive.io. agents/v1 needs the scope agent:provision and an agent with May create agents and keys; access/v1 accepts any agent credential. Pass as Authorization: Bearer <credential>.

Body

application/json
agent_id
string
required
grace
enum<string>

How long the agent's current key keeps working. Defaults to now.

Available options:
now,
1h,
24h,
7d
expires_in_days
integer

When the new key stops working. 0 or omitted means never.

Required range: 0 <= x <= 3650

Response

The new key, and the agent's address.

key_id
string
required
key
string
required

The new key. Shown once.

address
string
required
expires_at
string<date-time> | null
required
previous_key_valid_until
string<date-time> | null
required

When the replaced key stops; null when it already has.