A refused request
A refusal before payment is never charged. It has a non-2xx status:error. message may change. details is optional.
GET /v1/submissions/recover answers 404 submission_not_found with acceptance: unknown when it has no record of the key. Timeouts and retries says when submitting with that key is safe.
A failed job
GET /v1/requests/{request_id} answers 200 with:
error_code. error may change. LinkedIn failures put reason in result, plus upstream_reason, LinkedIn’s own error type, when it gave one. The TypeScript SDK throws a JobError with code and partialResult.
Categories
Unlisted codes are
internal. See also job status.
LinkedIn codes
For invite, withdraw, message and reply. Terminal: the same request cannot succeed. Retryable: it can, later.
Retry with a new
Idempotency-Key. The same key never sends again.
Unconfirmed sends and refunds
A timeout, server error or throttled send may still have reached LinkedIn. The job staysprocessing with send_status: "ambiguous" while OneShot checks, then reports send_unverified after 24 hours. It is not refunded, unless a throttled invitation is shown not to have been sent.
A request that fails before reaching LinkedIn is refunded as account credit within a day; refunds run daily at 03:00 UTC. The receipt gets a new signed revision marked failed.