Create Organization User Seller Agent

As an Organization Admin, create a seller agent for a user in your organization.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Authenticate with an Organization Admin User API key, sent in the skyfire-api-key header. Keys belonging to callers whose organization role is ADMIN are accepted; a MEMBER key, or any Agent API key, is rejected with 401.

The user identified by userId must belong to your organization and must be active. A user from another organization is reported as 404, and a deactivated user returns 400.

What this call creates

A single request creates:

  1. A seller agent owned by the user, with the displayName you supply.
  2. A wallet for that agent.
  3. An API key for that agent, returned as apiKey.

apiKey is returned only in this response and cannot be retrieved again. Store it securely before discarding the response.

One seller agent per user

Each organization user can own at most one seller agent. Calling this endpoint for a user who already has one returns 400, and the existing agent is left untouched. To give an organization several seller agents, create a separate user for each.

Path Params
string
required

Unique identifier of the organization user who will own the seller agent. Must be a user in your own organization. e.g. 58dbc331-c32a-4d65-8157-e11a59e5790d.

Body Params
string
required

Label for the new seller agent. Does not have to be unique. e.g. "Chloe Cupcakes".

Responses

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/json