Import Cost Entry Allocations
POST/api/cost-entries/:costEntry/allocations/import
Creates the given allocations on the cost entry, all or nothing, and recalculates the entry's status. Refused with 422 (nothing created) when they add up to more than the entry has left to allocate, or when a target no longer exists.
purchase-orders:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Body: allocations (required, 1–5000), each with type (product, brand, supplier, channel), allocatable_id (integer), amount (> 0, entry currency), and optional allocation_date, period_start + period_end (both or neither; end on or after start). Use the allocatable.id values returned by Validate Cost Entry Allocation Import.
Authentication: Requires Bearer token (scope purchase-orders:write).
Request
Responses
- 201
- 401
- 403
- 404
- 422
- 429
Created
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.