Whole list by default; with page or limit, paginated (25 by default, 500 at most).
Parameters
Name
In
Type
Required
Description
page
query
integer
no
limit
query
integer
no
page
query
integer
no
Numéro de page, à partir de 1
limit
query
integer
no
É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:ecrireCreate, reschedule, cancel and mark bookings; manage polls
Creation: the Idempotency-Key header prevents duplicates for 24 hours.
Parameters
Name
In
Type
Required
Description
Idempotency-Key
header
string
no
Une 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.
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:lireRead bookings and polls
Parameters
Name
In
Type
Required
Description
id
path
string
yes
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:ecrireCreate, reschedule, cancel and mark bookings; manage polls
Creation: the Idempotency-Key header prevents duplicates for 24 hours.
Parameters
Name
In
Type
Required
Description
id
path
string
yes
Idempotency-Key
header
string
no
Une 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
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:ecrireCreate, reschedule, cancel and mark bookings; manage polls
Creation: the Idempotency-Key header prevents duplicates for 24 hours.
Parameters
Name
In
Type
Required
Description
id
path
string
yes
Idempotency-Key
header
string
no
Une 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.