Create or update multiple dimensions
Allows for the creation or updating of multiple dimensions in a single request. The request body should contain a ottimate_company_id and an array of dimensions. Maximum 100 dimensions per request. Unlike POST /dimensions (single-create), this endpoint upserts: existing dimensions (matched by reference_id + erp_type) are updated, new dimensions are created. Validation is checked for every item before any writes happen — if any item is missing a required field or has an unresolvable type, the entire request is rejected with 400 and nothing is created or updated, including otherwise-valid items in the same batch.
Headers
OAuth2 authentication flows. Auth server URLs will vary by environment
API key for authentication
API version to use (optional, defaults to latest). Supported values: 1.0.0, 1.1.0.
Client-generated unique key (UUID/ULID recommended). JSON requests: the first 2xx response is cached for 24h and replayed on a same-key retry with a matching body; a different body returns 422. Non-JSON requests (e.g. file uploads): the key is single-use — any same-key retry returns 422 regardless of body. See Idempotency for full details.
Request body
Response
Successfully created and/or updated. Returned whenever at least one item in the batch succeeds — including batches where some items succeeded and others failed at the individual-record level (see fail_count/failures below); there is no separate 207 status for this case.