Bulk import agents from CSV
POST/agents/bulk-import
Uploads a CSV file (max 5 MB / 5000 rows) and creates one Agent per row. Row failures are collected but do not abort the batch. Pass dryRun=true to validate only. Emits per-row audit events. Requires the agent:write permission.
Request
Responses
- 200
- 201
- 400
- 401
- 403
- 429
- 500
Import summary with counts of created, skipped, and failed rows plus per-row errors.
Resource created. Body follows the shared { data, meta } envelope; data is the newly-created resource.
File missing or CSV malformed.
Missing or invalid access token.
Caller lacks the required permission.
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.