Set calendar availability

org.intentschema.productivity.calendar.availability.set.v1

JSON: bare · @sha256:7cb8b74a53c7…
Hash: sha256:7cb8b74a53c73c1e865fb4b1963b3c34dc2940b0f415dc5e634c25b731aa1c9b

Set the user's working hours, focus blocks, or out-of-office windows. The mode field selects which.

Payload

Field	Type	Description
`target` *	`Target`
`object` *	`object`
`idempotency_key`	`string`

object

Field	Type	Description
`mode` *	enum: `working_hours` \| `focus` \| `ooo`	Which availability concept to set.
`start`	`string` (date-time)
`end`	`string` (date-time)
`timezone`	`string`
`recurrence`	`string`	RFC 5545 RRULE for recurring working hours / focus blocks.
`auto_reply`	`string`	OOO auto-reply text. Sieve vacation (RFC 5230) on supporting providers.

Result

Field	Type	Description
`external_id` *	`string`	Provider-assigned id.
`created_at` *	`string` (date-time)

Examples

set OOO for vacation

{
  "target": {
    "system": "google_calendar"
  },
  "object": {
    "mode": "ooo",
    "start": "2026-05-01T00:00:00-07:00",
    "end": "2026-05-08T23:59:59-07:00",
    "auto_reply": "Out of office through May 8; replies will be slow."
  }
}

weekly focus block

{
  "target": {
    "system": "google_calendar"
  },
  "object": {
    "mode": "focus",
    "start": "2026-04-21T09:00:00-07:00",
    "end": "2026-04-21T11:00:00-07:00",
    "recurrence": "RRULE:FREQ=WEEKLY;BYDAY=TU,TH"
  }
}

Profiles

Google Calendar availability set profile — org.intentschema.productivity.calendar.availability.set.v1@com.google.calendar.v1