# Create availability slot

Creates a new Availability Slot record. Availability Slot resource in the Animal Health Data Store

Endpoint: POST /site/{siteId}/ahds/v1/availability-slot
Version: 1.0
Security: bearer

## Path parameters:

  - `siteId` (number, required)
    Site identifier

## Request fields (application/json):

  - `availabilitySlotId` (string, required)
    Canonical identifier for this availability slot.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `endAt` (string, required)
    End date and time of the availability slot (RFC 3339, with timezone).
    Example: "2025-01-01T00:00:00.000Z"

  - `extensions` (object)
    Vendor- or practice-specific extensions.

  - `isActive` (boolean, required)
    Indicates whether this slot is active and can be used for scheduling.

  - `isBooked` (boolean)
    Indicates whether this slot is currently booked.

  - `locationId` (string, required)
    Location (clinic/branch) where this slot occurs.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `notes` (string)
    Free-text notes about this availability slot.

  - `resourceId` (string, required)
    Primary resource for this slot (e.g., veterinarian, room).
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `serviceType` (object)
    Type of service this slot is intended for (e.g., consultation, surgery).

  - `serviceType.code` (string, required)
    Code value

  - `serviceType.system` (string, required)
    Code system URI

  - `serviceType.display` (string)
    Human-readable display

  - `startAt` (string, required)
    Start date and time of the availability slot (RFC 3339, with timezone).
    Example: "2025-01-01T00:00:00.000Z"

## Response 201 fields (application/json):

  - `availabilitySlotId` (string, required)
    Canonical identifier for this availability slot.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `createdAt` (string, required)
    Timestamp when this slot record was created.
    Example: "2025-01-01T00:00:00.000Z"

  - `endAt` (string, required)
    End date and time of the availability slot (RFC 3339, with timezone).
    Example: "2025-01-01T00:00:00.000Z"

  - `extensions` (object, required)
    Vendor- or practice-specific extensions.

  - `isActive` (boolean, required)
    Indicates whether this slot is active and can be used for scheduling.

  - `isBooked` (boolean, required)
    Indicates whether this slot is currently booked.

  - `locationId` (string, required)
    Location (clinic/branch) where this slot occurs.
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `notes` (string, required)
    Free-text notes about this availability slot.

  - `resourceId` (string, required)
    Primary resource for this slot (e.g., veterinarian, room).
    Example: "123e4567-e89b-12d3-a456-426614174000"

  - `serviceType` (object, required)
    Type of service this slot is intended for (e.g., consultation, surgery).

  - `serviceType.code` (string, required)
    Code value

  - `serviceType.system` (string, required)
    Code system URI

  - `serviceType.display` (string)
    Human-readable display

  - `startAt` (string, required)
    Start date and time of the availability slot (RFC 3339, with timezone).
    Example: "2025-01-01T00:00:00.000Z"

  - `updatedAt` (string, required)
    Timestamp when this slot record was last updated.
    Example: "2025-01-01T00:00:00.000Z"


## Response 400 fields

## Response 401 fields

## Response 409 fields