Skip to content

Meeting polls · API reference

Offer dates, follow the votes, confirm a date.

List polls

GET/polls

Scope : reservations:lire Read bookings and polls

Whole list by default; with page or limit, paginated (25 by default, 500 at most).

Parameters

NameInTypeRequiredDescription
pagequeryintegerno
limitqueryintegerno
pagequeryintegernoNuméro de page, à partir de 1
limitqueryintegernoÉléments par page (500 au plus)
Request example
curl -X GET 'https://www.artibox-calendar.com/api/v1/polls' \
  -H "x-api-key: $RDV_TOKEN"

Responses

  • 200 Success
  • 401 Missing, unknown or expired token
  • 403 Missing scope or right refused
  • 404 Not found (or another organisation's)
  • 422 Data refused: details are given field by field
  • 429 Too many calls: wait for Retry-After

Create a meeting poll

POST/polls

Scope : reservations:ecrire Create, reschedule, cancel and mark bookings; manage polls

Creation: the Idempotency-Key header prevents duplicates for 24 hours.

Parameters

NameInTypeRequiredDescription
Idempotency-KeyheaderstringnoUne clé de votre choix (255 caractères au plus) : rejouée dans les 24 heures, la même requête rend la première réponse sans rien recréer ; en cours, 409 ; sur une autre route, 422.

Request body

`{type_id, title?, guest_name, guest_email, guest_phone?, slots: [ISO 8601]}` — l'adresse n'est donnée qu'ici

Request example
curl -X POST 'https://www.artibox-calendar.com/api/v1/polls' \
  -H "x-api-key: $RDV_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H 'Content-Type: application/json' \
  -d '{"type_id":"0192f0c4-6a51-7c3e-9d0e-5b1f3a2c4d10","title":"Point d'\''étape","guest_name":"Camille Martin","guest_email":"camille.martin@example.com","slots":["2026-12-01T10:00:00+01:00","2026-12-02T15:00:00+01:00"]}'

Responses

  • 201 Created
  • 401 Missing, unknown or expired token
  • 403 Missing scope or right refused
  • 404 Not found (or another organisation's)
  • 409 Conflict: slot taken or request in progress
  • 422 Data refused: details are given field by field
  • 429 Too many calls: wait for Retry-After

Read a poll and its votes

GET/polls/{id}

Scope : reservations:lire Read bookings and polls

Parameters

NameInTypeRequiredDescription
idpathstringyes
Request example
curl -X GET 'https://www.artibox-calendar.com/api/v1/polls/{id}' \
  -H "x-api-key: $RDV_TOKEN"

Responses

  • 200 Success
  • 401 Missing, unknown or expired token
  • 403 Missing scope or right refused
  • 404 Not found (or another organisation's)
  • 422 Data refused: details are given field by field
  • 429 Too many calls: wait for Retry-After

Confirm a poll date (creates the booking)

POST/polls/{id}/confirm

Scope : reservations:ecrire Create, reschedule, cancel and mark bookings; manage polls

Creation: the Idempotency-Key header prevents duplicates for 24 hours.

Parameters

NameInTypeRequiredDescription
idpathstringyes
Idempotency-KeyheaderstringnoUne clé de votre choix (255 caractères au plus) : rejouée dans les 24 heures, la même requête rend la première réponse sans rien recréer ; en cours, 409 ; sur une autre route, 422.

Request body

`{start}` — un des créneaux du sondage ; 409 s'il n'est plus libre

Request example
curl -X POST 'https://www.artibox-calendar.com/api/v1/polls/{id}/confirm' \
  -H "x-api-key: $RDV_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H 'Content-Type: application/json' \
  -d '{"start":"2026-12-01T10:00:00+01:00"}'

Responses

  • 200 Success
  • 401 Missing, unknown or expired token
  • 403 Missing scope or right refused
  • 404 Not found (or another organisation's)
  • 409 Conflict: slot taken or request in progress
  • 422 Data refused: details are given field by field
  • 429 Too many calls: wait for Retry-After

Close a poll

POST/polls/{id}/close

Scope : reservations:ecrire Create, reschedule, cancel and mark bookings; manage polls

Creation: the Idempotency-Key header prevents duplicates for 24 hours.

Parameters

NameInTypeRequiredDescription
idpathstringyes
Idempotency-KeyheaderstringnoUne clé de votre choix (255 caractères au plus) : rejouée dans les 24 heures, la même requête rend la première réponse sans rien recréer ; en cours, 409 ; sur une autre route, 422.

Request body

Request example
curl -X POST 'https://www.artibox-calendar.com/api/v1/polls/{id}/close' \
  -H "x-api-key: $RDV_TOKEN" \
  -H "Idempotency-Key: $(uuidgen)"

Responses

  • 200 Success
  • 401 Missing, unknown or expired token
  • 403 Missing scope or right refused
  • 404 Not found (or another organisation's)
  • 409 Conflict: slot taken or request in progress
  • 422 Data refused: details are given field by field
  • 429 Too many calls: wait for Retry-After