Astrocal
API ReferenceBookingsV1BookingsIdReschedule

Reschedule a booking

Reschedules a booking to a new time. Supports two authentication methods: a cancel token via `?token=` query param (for invitee self-service), or an API key via `Authorization: Bearer` header (for developers). Validates the new slot against availability rules and existing bookings.

POST
/v1/bookings/{id}/reschedule

Path Parameters

id*string
Formatuuid

Query Parameters

token?string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/bookings/497f6eca-6276-4993-bfeb-53cbbbba6f08/reschedule" \  -H "Content-Type: application/json" \  -d '{    "new_start_time": "2019-08-24T14:15:22Z"  }'
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
  "event_type_id": "a4ec4c3c-a3de-4a8a-983f-1791e72cea83",
  "calendar_connection_id": "ff9acdf1-5b4a-487f-8d79-314da6436092",
  "assigned_host": {
    "member_id": "435a4844-006a-4cfc-a644-e8eb2dd2ca43",
    "name": "string",
    "email": "string"
  },
  "status": "confirmed",
  "is_test": true,
  "start_time": "string",
  "end_time": "string",
  "invitee_name": "string",
  "invitee_email": "string",
  "invitee_timezone": "string",
  "attendee_count": 0,
  "attendees": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "name": "string",
      "email": "string",
      "timezone": "string",
      "is_primary": true
    }
  ],
  "notes": "string",
  "cancel_token": "string",
  "calendar_event_id": "string",
  "metadata": {
    "property1": null,
    "property2": null
  },
  "cancelled_at": "string",
  "cancel_reason": "string",
  "created_at": "string",
  "updated_at": "string"
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": {
      "property1": null,
      "property2": null
    }
  }
}

Cancel a booking

Cancels a booking. Supports two authentication methods: a cancel token via `?token=` query param (for invitee self-service), or an API key via `Authorization: Bearer` header (for developers). Idempotent — cancelling an already-cancelled booking returns success.

Get branding settings

Returns the organization's branding settings including logo URL and branding toggle.