Skip to main content
POST
Start a historical backfill

Authorizations

Authorization
string
header
required

Authorization: Bearer <token>. Token types resolve to the same scoped credential: a user-generated API key (casa_…, from Account settings — recommended for machines and MCP clients), a WorkOS AuthKit session JWT (the web app; org and role come from verified token claims), or a static token. API keys are group-scoped, optionally pinned to one property at creation. MCP OAuth connector tokens authenticate the MCP server only and are rejected on these REST routes.

Path Parameters

id
string<uuid>
required

Resource id (UUID).

Body

application/json
integration_id
string<uuid>
required
start_date
string<date>
required
end_date
string<date>
required
date_basis
enum<string>

Which provider date field defines the import window. Defaults to stay_date. Not all providers support every basis.

Available options:
stay_date,
booking_created_at

Response

Backfill running (or already in progress).

state
string
Example:

"running"

started
boolean

true when this request claimed a new run; false when a run was already in progress (no new workflow started).

data
object