Import report
Imports one standalone PDF or a legacy XML/CSV/XLSX/DXF report package. The API key supplies the workspace; tenant selector fields are rejected.
Bearer API key · Scope: reports.write
Endpoint
Request bodyrequired
multipart/form-data
ReportImportFormHeaders2 parameters
Idempotency-Keyrequiredstring—
Content-LengthrequiredintegerRequired for multipart report imports before request parsing. Most HTTP clients compute this automatically for multipart form uploads.
Responses
201Report imported.
Headers
X-RateLimit-LimitMaximum requests allowed in the current window.X-RateLimit-RemainingRequests remaining in the current window.X-RateLimit-ResetISO timestamp when the current rate-limit window resets.Idempotency-ReplayedPresent and true when a stored successful write response was replayed.
application/json
ReportImportResponse400Request payload, query, or required header is invalid.
application/json
ErrorResponse401Missing, malformed, revoked, deleted, or unknown API key.
Headers
WWW-AuthenticateDocumented response header
application/json
ErrorResponse403API key lacks the required scope or the workspace is not active.
application/json
ErrorResponse409Request conflicts with idempotency or external event identity.
application/json
ErrorResponse411Request payload, query, or required header is invalid.
application/json
ErrorResponse413Request payload, query, or required header is invalid.
application/json
ErrorResponse429Rate limit exceeded for this key and endpoint or invalid-auth bucket.
Headers
X-RateLimit-LimitMaximum requests allowed in the current window.X-RateLimit-RemainingRequests remaining in the current window.X-RateLimit-ResetISO timestamp when the current rate-limit window resets.Retry-AfterSeconds until the caller should retry.
application/json
ErrorResponse500Internal authentication or server error.
application/json
ErrorResponse503Internal authentication or server error.
application/json
ErrorResponse