Register a new IRA licence for an agent
POST/agents/:agentId/licences
Creates an AgentLicense record after validating the licence number against the configured ID pattern and ensuring no duplicate exists for the agent. Emits an agent_license.create audit event. Requires the agent-license:write permission.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 409
- 429
- 500
Newly-created AgentLicense record.
Payload invalid, dates out of range or referenced document missing.
Missing or invalid access token.
Caller lacks the required permission.
Agent not found.
Licence number already exists for this agent.
Rate limit exceeded. Global default is 120 requests/minute per IP; auth-flow, OTP, self-registration, WebAuthn, IRA lookup, and public-lead endpoints carry tighter per-endpoint limits. Retry after the delay indicated by the Retry-After header.
Response Headers
Seconds to wait before retrying.
Unhandled server error. The response carries a meta.requestId correlator you can hand to platform operations to trace the failure through structured logs and the hash-chained audit trail. Retry with the same Idempotency-Key header if the endpoint accepts idempotency.