Import a CSV file
POST/v1/imports
Stores the valid rows of a file and records an import batch. A problem with one row rejects that row only, and the response lists every problem of each rejected row, one errors entry per problem. Events deduplicate as on POST /v1/events. Idempotency-Key protects the import batch record that each commit creates.
Request
Responses
- 200
- 400
- 401
- 403
- 409
- 413
- 414
- 415
- 422
- 429
- 500
The file was imported. Rows that failed are in errors.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
Sent on every response to an API key once the rate limiter has run: absent on 401 and 403, and on every response to a session. The quota left in the one policy the request consumed, as IETF draft-ietf-httpapi-ratelimit-headers-11 specifies, e.g. "api";r=599;t=1. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change. Do not base retries on it; retry on Retry-After.
Sent whenever RateLimit is. Every policy the key is subject to, as IETF draft-11 specifies. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change.
true when this response is a replay of the stored response to an earlier request with the same Idempotency-Key; absent on the first response. The resource was not created again.
invalid_json: the body is not one JSON object. validation_failed: a field, parameter, header or multipart part breaks a rule; errors lists every problem.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
Sent on every response to an API key once the rate limiter has run: absent on 401 and 403, and on every response to a session. The quota left in the one policy the request consumed, as IETF draft-ietf-httpapi-ratelimit-headers-11 specifies, e.g. "api";r=599;t=1. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change. Do not base retries on it; retry on Retry-After.
Sent whenever RateLimit is. Every policy the key is subject to, as IETF draft-11 specifies. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change.
No credential, or the credential failed.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
RFC 9110 §11.6.1 and RFC 6750 §3. Bearer alone when no credential, or a credential under another scheme, was sent. Bearer error="invalid_token" when the credential failed. A 403 insufficient_scope carries its own challenge, declared on the Forbidden responses.
insufficient_scope: the API key lacks the operation's scope, which WWW-Authenticate names. account_not_provisioned: the session's user has no workspace.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
Sent with insufficient_scope only: Bearer error="insufficient_scope", scope="<scope>".
idempotency_key_in_use: the request conflicts with the current state.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
Sent on every response to an API key once the rate limiter has run: absent on 401 and 403, and on every response to a session. The quota left in the one policy the request consumed, as IETF draft-ietf-httpapi-ratelimit-headers-11 specifies, e.g. "api";r=599;t=1. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change. Do not base retries on it; retry on Retry-After.
Sent whenever RateLimit is. Every policy the key is subject to, as IETF draft-11 specifies. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change.
The body is over the operation's limit: its x-body-limit, or the 1M default when it declares none.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
Sent on every response to an API key once the rate limiter has run: absent on 401 and 403, and on every response to a session. The quota left in the one policy the request consumed, as IETF draft-ietf-httpapi-ratelimit-headers-11 specifies, e.g. "api";r=599;t=1. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change. Do not base retries on it; retry on Retry-After.
Sent whenever RateLimit is. Every policy the key is subject to, as IETF draft-11 specifies. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change.
The query string holds more than 10,000 parameters. Every &-separated pair counts, empty ones included. No parameter is at fault on its own, so the response carries no errors.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
Sent on every response to an API key once the rate limiter has run: absent on 401 and 403, and on every response to a session. The quota left in the one policy the request consumed, as IETF draft-ietf-httpapi-ratelimit-headers-11 specifies, e.g. "api";r=599;t=1. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change. Do not base retries on it; retry on Retry-After.
Sent whenever RateLimit is. Every policy the key is subject to, as IETF draft-11 specifies. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change.
The Content-Type is not one this operation takes, or names a charset other than utf-8 on a JSON media type.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
Sent on every response to an API key once the rate limiter has run: absent on 401 and 403, and on every response to a session. The quota left in the one policy the request consumed, as IETF draft-ietf-httpapi-ratelimit-headers-11 specifies, e.g. "api";r=599;t=1. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change. Do not base retries on it; retry on Retry-After.
Sent whenever RateLimit is. Every policy the key is subject to, as IETF draft-11 specifies. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change.
The Idempotency-Key was used in the last 24 hours with a different request.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
Sent on every response to an API key once the rate limiter has run: absent on 401 and 403, and on every response to a session. The quota left in the one policy the request consumed, as IETF draft-ietf-httpapi-ratelimit-headers-11 specifies, e.g. "api";r=599;t=1. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change. Do not base retries on it; retry on Retry-After.
Sent whenever RateLimit is. Every policy the key is subject to, as IETF draft-11 specifies. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change.
The API key is over its rate limit.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
Seconds to wait before retrying (RFC 9110 §10.2.3). Takes precedence over the RateLimit fields.
Sent on every response to an API key once the rate limiter has run: absent on 401 and 403, and on every response to a session. The quota left in the one policy the request consumed, as IETF draft-ietf-httpapi-ratelimit-headers-11 specifies. On a 429 it is r=0, and t equals Retry-After, e.g. "api";r=0;t=1. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change. Do not base retries on it; retry on Retry-After.
Sent whenever RateLimit is. Every policy the key is subject to, as IETF draft-11 specifies. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change.
An unexpected error. Nothing was stored.
Response Headers
The request's id, to quote in support requests. Echoes the request's X-Request-Id when it was at most 200 bytes of visible ASCII; otherwise generated.
Sent on every response to an API key once the rate limiter has run: absent on 401 and 403, and on every response to a session. The quota left in the one policy the request consumed, as IETF draft-ietf-httpapi-ratelimit-headers-11 specifies, e.g. "api";r=599;t=1. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change. Do not base retries on it; retry on Retry-After.
Sent whenever RateLimit is. Every policy the key is subject to, as IETF draft-11 specifies. It tracks the draft, and may change to follow a newer draft without being treated as a breaking change.