Conferencer API

A read/write REST API over one event's programme. Machine-readable spec: /api/v1/openapi.json.

Authentication

Create a token in Settings → API tokens, then send it as a bearer token. Tokens are scoped to a single event.

curl -H "Authorization: Bearer cft_xxx" \
  "$APP_URL/api/v1/submissions?status=accepted&limit=25"

Every list endpoint accepts limit, cursor, updated_since and resource-specific filters, and replies with { data, meta: { count, limit, next_cursor } }.

Resources

/api/v1/eventsGET
The event this token is scoped to.
/api/v1/submissionsGET · POST · PATCH · DELETE
Abstracts and sessions. Filter with ?status= &kind= &track_id= &q=.
/api/v1/submissions/{id}/participantsGET
Speakers on a submission.
/api/v1/submissions/bulk-statusPOST
Change many statuses at once. Accepting runs the full hand-off.
/api/v1/sessionsGET · POST
Submissions filtered to kind=session.
/api/v1/contactsGET · POST
People, org-scoped, matched by email.
/api/v1/contacts/bulk-upsertPOST
Upsert many contacts in one call.
/api/v1/speakersGET
The event roster with speaker status.
/api/v1/participantsGET · POST
Submission ↔ contact links with roles.
/api/v1/formsGET
Submission forms and their windows.
/api/v1/tracksGET · POST
Programme tracks.
/api/v1/formatsGET · POST
Session formats and durations.
/api/v1/roomsGET · POST
Rooms available for scheduling.
/api/v1/tasksGET
The onboarding task library.
/api/v1/task-assignmentsGET · POST
Who owes what. ?contact_id= filters to one speaker.
/api/v1/task-assignments/bulkPOST
Assign many tasks in one call.
/api/v1/evaluation-plansGET
Review plans and rounds.
/api/v1/reviewsGET
Aggregate scores per submission.
/api/v1/uploadsGET
Every uploaded deliverable with metadata.
/api/v1/emailsGET
The outbox.
/api/v1/public/sessionsGET
No token needed. Approved, accepted, published sessions.
/api/v1/public/speakersGET
No token needed. Public speaker list.

Webhooks

Register an endpoint in Settings → Webhooks to receive submission.created, submission.status_changed, task.completed and session.scheduled as they happen.

POST https://your-app.example.com/hooks
X-Conferencer-Event: submission.status_changed
X-Conferencer-Signature: sha256=<hmac of the raw body with your endpoint secret>

{"type":"submission.status_changed","event_id":"…","created_at":"…",
 "data":{"id":"…","title":"…","from":"pending","to":"accepted"}}

Deliveries time out after 5 seconds and never block the action that triggered them.

Public feeds without a token

Every embed also exposes JSON, XML and iCal at /e/:slug/embed/:token.json, ?format=xml and .ics. Generate one in Site & embeds.