Answer an invitation

POST/api/v1/mailbox/calendar/invitations/{invitation_id}/rsvp
Requires amailbox token— it acts as one mailbox holder, not as the organization.

Accepts, declines or tentatively accepts. The organizer is emailed the answer and, unless declined, the event goes in calendar.

Errors

Status When
401 No token, or the session expired or was signed out. Sign in again with POST /mailbox-auth/login.
403 The account has a temporary password: until POST /security/password succeeds, every other call answers this with error_code: password_change_required.
404 That invitation is no longer there.
422 response is not accepted, declined or tentative, or the invitation cannot be read.

Parameters

NameInTypeDescription
invitation_idrequiredpathstring

Request body

  • responsestringrequired

    accepted, declined or tentative.

  • calendarstring

    Where to put the event (default default).

Request

POST/api/v1/mailbox/calendar/invitations/{invitation_id}/rsvp
curl -X POST 'https://courier.mailyte.com/api/v1/mailbox/calendar/invitations/01JBT8XQ2M9WYC3K4F6R7S8T9V/rsvp' \
  -H 'Authorization: Bearer MAILBOX_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "response": "accepted",
    "calendar": "default"
  }'

Response

Successful Response

  • dataobject
    • idstring
    • responsestring
200application/json
{
  "type": "success",
  "msg": "Your answer has been sent",
  "data": {
    "id": "8f14e45f.ics",
    "response": "accepted"
  }
}

Returned inside the standard envelope.

Errors

StatusWhen
401No token, or the session expired or was signed out. Sign in again with `POST /mailbox-auth/login`.
403The account has a temporary password: until `POST /security/password` succeeds, every other call answers this with `error_code: password_change_required`.
404`That invitation is no longer there`.
422`response` is not accepted, declined or tentative, or the invitation cannot be read.

Every status, with what causes it and what to do, is on the error reference.