API Reference
Job Status
Track asynchronous pin publish execution state.
Overview
Pins are processed asynchronously. Use job and pin status endpoints to drive retries, UI updates, and alerting.
What You Will Learn
- Difference between pin resource status and job alias response.
- Polling cadence for queued/publishing states.
- How to map error_code and error_message to remediation.
Implementation Checklist
- Store pin IDs from create responses.
- Poll /v1/pins/{pin_id} or /v1/jobs/{job_id} with backoff.
- Stop polling once status is published or failed.
Relevant Endpoints
GET
/v1/pins/{pin_id}Primary lifecycle endpoint.
GET
/v1/jobs/{job_id}Job alias endpoint for pin status.