Bulk Retry Numeral Sync Records
POST/api/numeral/instances/:instance/records/retry
Queues several records to be sent again — either by id, or every record matching the same filters as List Numeral Sync Records.
accounting:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Body fields (one of):
- ids (array of integers, max 5000): record ids of this connection.
- filter (object): any of status (failed, needs_action, held or skipped — when omitted, all four), reason_code, syncable_type (sales_order, sales_invoice, sales_credit), sales_channel_id (integer), is_backfill (boolean), date_from / date_to (document date), search (document number or Numeral order id). An empty object
{}retries every retryable record.
Send exactly one of ids or filter.
Returns the number of records queued.
Authentication: Requires a Bearer token. Requires the integrations.sync permission.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 429
OK
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.
Validation failed — the body is a field → messages map (Laravel shape) or the platform envelope with a stable machine-readable code. Fix the payload and resubmit.
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.