Skip to Content
API Reference

Interviews

v1Updated 2026-03-07

Get interviews

GET/api/v1/public/:tenant_slug/interviews
NameTypeRequiredDescription
filter[scheduling_link_id]integernoFilter by scheduling link.
filter[candidate_id]integernoFilter by candidate.
filter[placement_id]integernoFilter by placement/application.
filter[status]stringnoscheduled/cancelled/…
filter[host_member_id]integernoFilter by host.

Create interview

POST/api/v1/public/:tenant_slug/interviews
Request
curl -X POST \ -H "Authorization: Bearer <API_KEY>" \ -H "Idempotency-Key: interview-create-001" \ -H "Content-Type: application/json" \ -d '{"scheduling_link_id":9,"candidate_id":504,"guest_name":"Ana Novak","guest_email":"ana@mail.com","scheduled_at":"2026-03-08T09:30:00Z"}' \ "http://localhost:3333/api/v1/public/agado-ats/interviews"
201 Response
{ "data": { "id": 220, "status": "scheduled", "guest_name": "Ana Novak", "guest_email": "ana@mail.com" } }
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" } }