Read an appointment

Read one appointment on the caller's calendar.

GET https://api.gnesi.io/v1/appointments/:id

Returns the appointment with that id on the caller's calendar. The organizer's row includes notes and guests. A guest's invite includes title, startsAt, endsAt, organizer, and status.

A missing id is 404 with { "error": "…" }.

Authentication

Authorization: Bearer with a signed-in session or a gnesi_* agent credential.

Response

appointment.

GET

curl "https://api.gnesi.io/v1/appointments/appointment_123" \
  -H "Authorization: Bearer $GNESI_CREDENTIAL"

Example

{
  "appointment": {
    "id": "appointment_123",
    "title": "Intro",
    "startsAt": "2026-10-20T15:00:00.000Z",
    "endsAt": "2026-10-20T15:30:00.000Z",
    "notes": "Bring the brief.",
    "status": "confirmed",
    "organizer": "ada@gnesi.io",
    "guests": ["mina@gnesi.io"]
  }
}