API reference

Schedule overrides

Replace one resource’s hours for one local date. An empty list means not working that day.

Create a schedule override

POST/v1/schedule_overrides

Replaces a resource’s hours for one local date. One per resource per date.

Send the business’s id in Tiempo-Account.

Body parameters

resourcestringrequired
A resource id.
datedaterequired
A local date, YYYY-MM-DD.
intervalsarray of objectsrequired
The hours for that date, { start, end, location? } in HH:mm. Empty means not working.
- startstringrequired
  An ISO-8601 instant.
- endstringrequired
  An ISO-8601 instant, after start.
- locationstring
  A location id.
metadatamap
Up to 50 keys of your own (strings, keys up to 40 characters, values up to 500). Returned on every read and webhook. On update, an empty string removes a key.

POST /v1/schedule_overrides

curl -X POST "https://api.tiempo.one/v1/schedule_overrides" \
  -H "Authorization: Bearer tpt_4qZ8m1VwXc0L…" \
  -H "Tiempo-Account: acct_01m42yt93ayvyrwr3yczhv6yhw" \
  -H "Content-Type: application/json" \
  -d '{
    "resource": "res_ann",
    "date": "2026-12-24",
    "intervals": [
      {
        "start": "09:00",
        "end": "13:00"
      }
    ]
  }'

200Response

{
  "id": "ovr_01m4h3a1b2c3d4e5f6g7h8j9k0",
  "object": "schedule_override",
  "livemode": false,
  "resource": "res_01m42ytc9b53589z4rp11zedjy",
  "date": "2026-12-24",
  "intervals": [
    {
      "start": "09:00",
      "end": "13:00",
      "location": null
    }
  ],
  "metadata": {},
  "created_at": "2026-10-04T08:00:20Z"
}

List schedule overrides

GET/v1/schedule_overrides

Send the business’s id in Tiempo-Account.

Query parameters

resourcestring
Only those involving this resource. On the calendar, repeat it for several.
from_datedate
From this local date (YYYY-MM-DD), inclusive.
to_datedate
To this local date (YYYY-MM-DD), inclusive.
limitinteger
1 to 100. Defaults to 20.
starting_afterstring
An object id from the previous page; returns the page after it.
ending_beforestring
An object id; returns the page before it.
metadata[key]string
Only objects whose metadata has this key and value. Repeat for several.

GET /v1/schedule_overrides

curl "https://api.tiempo.one/v1/schedule_overrides?resource=res_ann&from_date=2026-12-01" \
  -H "Authorization: Bearer tpt_4qZ8m1VwXc0L…" \
  -H "Tiempo-Account: acct_01m42yt93ayvyrwr3yczhv6yhw"

200Response

{
  "object": "list",
  "data": [
    {
      "id": "ovr_01m4h3a1b2c3d4e5f6g7h8j9k0",
      "object": "schedule_override",
      "livemode": false,
      "resource": "res_01m42ytc9b53589z4rp11zedjy",
      "date": "2026-12-24",
      "intervals": [
        {
          "start": "09:00",
          "end": "13:00",
          "location": null
        }
      ],
      "metadata": {},
      "created_at": "2026-10-04T08:00:20Z"
    }
  ],
  "has_more": false
}

Retrieve a schedule override

GET/v1/schedule_overrides/{id}

Send the business’s id in Tiempo-Account.

Path parameters

idstringrequired
The object’s id.

GET /v1/schedule_overrides/{id}

curl "https://api.tiempo.one/v1/schedule_overrides/ovr_01m4h3a1b2c3d4e5f6g7h8j9k0" \
  -H "Authorization: Bearer tpt_4qZ8m1VwXc0L…" \
  -H "Tiempo-Account: acct_01m42yt93ayvyrwr3yczhv6yhw"

200Response

{
  "id": "ovr_01m4h3a1b2c3d4e5f6g7h8j9k0",
  "object": "schedule_override",
  "livemode": false,
  "resource": "res_01m42ytc9b53589z4rp11zedjy",
  "date": "2026-12-24",
  "intervals": [
    {
      "start": "09:00",
      "end": "13:00",
      "location": null
    }
  ],
  "metadata": {},
  "created_at": "2026-10-04T08:00:20Z"
}

Update a schedule override

POST/v1/schedule_overrides/{id}

Changes the hours or metadata for that date. The resource and date are fixed: to move an override, delete it and create another. Bookings the new hours don’t cover are flagged conflicted.

Send the business’s id in Tiempo-Account.

Path parameters

idstringrequired
The object’s id.

Body parameters

intervalsarray of objects
The hours for that date, { start, end, location? } in HH:mm. Empty means not working.
- startstringrequired
  An ISO-8601 instant.
- endstringrequired
  An ISO-8601 instant, after start.
- locationstring
  A location id.
metadatamap
Up to 50 keys of your own (strings, keys up to 40 characters, values up to 500). Returned on every read and webhook. On update, an empty string removes a key.

POST /v1/schedule_overrides/{id}

curl -X POST "https://api.tiempo.one/v1/schedule_overrides/ovr_01m4h3a1b2c3d4e5f6g7h8j9k0" \
  -H "Authorization: Bearer tpt_4qZ8m1VwXc0L…" \
  -H "Tiempo-Account: acct_01m42yt93ayvyrwr3yczhv6yhw" \
  -H "Content-Type: application/json" \
  -d '{
    "intervals": [
      {
        "start": "09:00",
        "end": "13:00"
      }
    ]
  }'

200Response

{
  "id": "ovr_01m4h3a1b2c3d4e5f6g7h8j9k0",
  "object": "schedule_override",
  "livemode": false,
  "resource": "res_01m42ytc9b53589z4rp11zedjy",
  "date": "2026-12-24",
  "intervals": [
    {
      "start": "09:00",
      "end": "13:00",
      "location": null
    }
  ],
  "metadata": {},
  "created_at": "2026-10-04T08:00:20Z"
}

Delete a schedule override

DELETE/v1/schedule_overrides/{id}

Send the business’s id in Tiempo-Account.

Path parameters

idstringrequired
The object’s id.

DELETE /v1/schedule_overrides/{id}

curl -X DELETE "https://api.tiempo.one/v1/schedule_overrides/ovr_01m4h3a1b2c3d4e5f6g7h8j9k0" \
  -H "Authorization: Bearer tpt_4qZ8m1VwXc0L…" \
  -H "Tiempo-Account: acct_01m42yt93ayvyrwr3yczhv6yhw"

200Response

{
  "id": "…",
  "object": "…",
  "deleted": true
}