As an Organization Admin, create a new API key for an agent belonging to a user in your organization.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Authenticate with an Organization Admin User API key, sent in the skyfire-api-key header. Keys belonging to Organization Admins are accepted; a MEMBER key, or any Agent API key, is rejected with 401.
The agent is resolved through the ownership chain organization → user → agent, all scoped to your own organization. A user or agent that does not exist, belongs to another organization, or is not owned by the given user returns 404. The agent must be active. An inactive agent also returns 404.
The raw key is returned only in this response and cannot be retrieved again. Store it securely on receipt. Afterwards the key is identified only by its
idandlastFour.
The new key is active immediately. An agent can hold multiple active keys at once. Use the optional notes field to label keys for rotation tracking.