> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clinikapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Appointment Responses

> SDK reference for appointment response operations.

# clinik.appointmentResponses

Appointment responses represent a participant's reply to an appointment — accepting, declining, tentatively accepting, or requesting a new time.

## create

```ts theme={null}
const { data, meta } = await clinik.appointmentResponses.create(request): Promise<ApiResponse<AppointmentResponse>>
```

| Field               | Type     | Required | Description                                      |
| ------------------- | -------- | -------- | ------------------------------------------------ |
| `appointmentId`     | `string` | Yes      | The appointment this response relates to         |
| `participantStatus` | `string` | Yes      | accepted, declined, tentative, needs-action      |
| `actorId`           | `string` | No       | The participant (Patient/Practitioner reference) |
| `participantType`   | `string` | No       | Role of participant                              |
| `start`             | `string` | No       | Proposed new start time                          |
| `end`               | `string` | No       | Proposed new end time                            |
| `comment`           | `string` | No       | Additional comments                              |

## Example

```ts theme={null}
// Accept an appointment
const { data } = await clinik.appointmentResponses.create({
  appointmentId: 'appt_abc123',
  participantStatus: 'accepted',
  actorId: 'Practitioner/prac_def456',
  comment: 'Confirmed — see you then.',
});

// Propose a new time
const { data: counter } = await clinik.appointmentResponses.create({
  appointmentId: 'appt_abc123',
  participantStatus: 'tentative',
  actorId: 'Patient/pt_xyz789',
  start: '2025-02-03T10:00:00Z',
  end: '2025-02-03T10:30:00Z',
  comment: 'Can we move to Monday morning instead?',
});
```

## read / update / delete / search

Same pattern as other resources. Search supports `appointmentId`, `actorId`, `participantStatus` filters.