API Reference

Attachments

v1Updated 2026-03-07

GET/api/v1/public/:tenant_slug/attachments

POST/api/v1/public/:tenant_slug/attachments

POST/api/v1/public/:tenant_slug/attachments/:id/signed_url

GET/api/v1/public/:tenant_slug/attachments/:id/checksum

POST/api/v1/public/:tenant_slug/attachments/:id/retry_download

Name	Type	Required	Description
id	integer	yes	Attachment ID.
candidate_id	integer	no	Filter/list by candidate.
placement_id	integer	no	Filter/list by placement.

Request


curl -H "Authorization: Bearer <API_KEY>" \
  "http://localhost:3333/api/v1/public/agado-ats/attachments"


curl -X POST \
  -H "Authorization: Bearer <API_KEY>" \
  "http://localhost:3333/api/v1/public/agado-ats/attachments/990/signed_url"

200 Response


{
  "data": {
    "id": 990,
    "filename": "CV_Ana_Novak.pdf",
    "signed_url": "https://..."
  }
}

400 Response


{
  "error": {
    "code": "bad_request",
    "message": "Validation failed for request payload",
    "request_id": "req_123"
  }
}

500 Response


{
  "error": {
    "code": "internal_error",
    "message": "Unexpected server error",
    "request_id": "req_500"
  }
}