# Novacal Docs

## Docs

- [Errors](https://docs.novacal.io/api-reference/errors.md): Understand Novacal API error responses, HTTP status codes, and the JSON error format returned when requests fail or validation does not pass.
- [Introduction](https://docs.novacal.io/api-reference/introduction.md): Learn how the Novacal API works, how authentication is handled, and what to expect from requests and responses.
- [Get Availability](https://docs.novacal.io/api-reference/v1/availability/get.md): Retrieve availability ranges for a Novacal event type across a selected date window so you can show bookable times in your app.
- [Create Booking Form Field](https://docs.novacal.io/api-reference/v1/booking-forms/create.md): Create a new booking form field for a Novacal event type, including label, field type, placeholder, required state, and options.
- [Delete Booking Form Field](https://docs.novacal.io/api-reference/v1/booking-forms/delete.md): Delete a booking form field from a Novacal event type by field ID and review the endpoint path, auth requirements, and success response.
- [Get Booking Form Fields](https://docs.novacal.io/api-reference/v1/booking-forms/get.md): List all booking form fields for a Novacal event type, including labels, input types, placeholders, display order, and options.
- [Update Booking Form Field](https://docs.novacal.io/api-reference/v1/booking-forms/update.md): Update a Novacal booking form field and change its label, input type, placeholder, required state, active status, order, or options.
- [Update Booking Form Field Order](https://docs.novacal.io/api-reference/v1/booking-forms/update-order.md): Reorder booking form fields for a Novacal event type by updating field positions in a single API request with ordered IDs.
- [Create Event Type](https://docs.novacal.io/api-reference/v1/event-types/create.md): Create a new Novacal event type with settings for duration, availability, booking limits, buffers, redirects, and booking form fields.
- [Delete Event Type](https://docs.novacal.io/api-reference/v1/event-types/delete.md): Delete a Novacal event type by ID and review the endpoint path, authentication requirements, and no-content success response.
- [Get Event Type](https://docs.novacal.io/api-reference/v1/event-types/find.md): Retrieve one Novacal event type by ID, including its scheduling settings, booking limits, visibility, and active booking form fields.
- [Get Event Types](https://docs.novacal.io/api-reference/v1/event-types/get.md): List the Novacal event types available to the authenticated user, including names, durations, visibility settings, and form fields.
- [Update Event Type](https://docs.novacal.io/api-reference/v1/event-types/update.md): Update an existing Novacal event type and change scheduling rules, limits, colors, visibility, redirects, and related configuration.
- [Cancel Event](https://docs.novacal.io/api-reference/v1/events/cancel.md): Cancel an existing Novacal event with the API, including the required public authentication flow and optional cancellation reason payload.
- [Book Event](https://docs.novacal.io/api-reference/v1/events/create.md): Book a new Novacal event with the public API by sending the event type, selected time, attendee answers, timezone, and location data.
- [Get Event](https://docs.novacal.io/api-reference/v1/events/find.md): Retrieve a single Novacal event by ID and inspect its booking details, timing, status, organizer, guests, and submitted form answers.
- [Get Events](https://docs.novacal.io/api-reference/v1/events/get.md): List the Novacal events the authenticated user can access, including scheduling details, attendees, hosts, and current event status.
- [Reschedule Event](https://docs.novacal.io/api-reference/v1/events/update.md): Reschedule an existing Novacal event with the public API by updating the start time, end time, timezone, and allowed booking answers.
- [Get Team](https://docs.novacal.io/api-reference/v1/teams/find.md): Retrieve a single Novacal team by ID, including its name, username, branding details, and other team profile information.
- [Get Teams](https://docs.novacal.io/api-reference/v1/teams/get.md): List all Novacal teams the authenticated user belongs to and review the team data returned by the teams collection endpoint.
- [Get Current User](https://docs.novacal.io/api-reference/v1/users/me.md): Retrieve the currently authenticated Novacal user, including profile details such as name, email, timezone, avatar, and time format.
- [Update Current User](https://docs.novacal.io/api-reference/v1/users/update-me.md): Update the authenticated Novacal user's profile, including username, email, name, avatar, timezone, week start, and time format.

## OpenAPI Specs

- [openapi](https://docs.novacal.io/api-reference/openapi.json)