Error catalogue

unauthorized

401

PulbiAPI key / IP allowlist only. Never an origin session.

invalid_url

400

URL that is not an extractable publication.

invalid_request

400

Malformed request.

unsupported_content

400

Story/Highlight refused without a fetch.

unsupported_platform

400

Hostname outside the public catalogue.

end_user_required

400

Bot keys require x-end-user-id.

insufficient_scope

403

The key does not have the scope for this operation.

platform_not_allowed

403

The platform is not in the key entitlement.

end_user_banned

403

End-user access is suspended.

platform_auth_required

403

The origin requires a session. Public mode does not sign in.

private_content

403

Explicitly private content.

privacy_undetermined

403

Could not confirm the content is public.

not_found

404

Content or job not found.

conflict

409

Conflict with the current state.

key_limit_reached

409

The workspace active-key limit was reached.

issuance_no_grant

403

The workspace has no issuance policy.

issuance_grant_suspended

403

Key issuance for this workspace is suspended.

issuance_workspace_suspended

403

The workspace is suspended.

idempotency_conflict

409

Idempotency-Key reused with a different body.

rate_limited

429

Too many requests. See Retry-After.

quota_exceeded

429

Daily quota exhausted.

geo_blocked

451

Content unavailable in this region.

extraction_failed

502

Extraction failed. It may be retryable.

platform_unavailable

503

Platform or transport temporarily unavailable.

timeout

504

Extraction took too long.

internal_error

500

Sanitized internal error. No origin detail.