CalendarEvent
/api/v1/employee/calendar-eventsA calendar entry for a Person.
listgetcreateupdatedeleteSchema
| Field | Type | Notes |
|---|---|---|
| id* | uuid | Server-assigned ULID with type prefix (e.g. per_…). |
| tenant_id* | string | Tenant scope — auto-stamped from the caller's JWT. |
| app_id | string | App scope. Stamped ONLY when the caller's JWT was minted for a specific Application (integration API keys). Absent for human-user sessions. Filters reads when present. |
| created_at* | date-time | Server stamp. |
| updated_at* | date-time | Server stamp; updated on every patch. |
| created_by | uuid | Person id from the caller's JWT (sub). |
| updated_by | uuid | Person id from the last writer's JWT (sub). |
| source | string | Provenance tag — defaults to 'edm'. |
| source_type | enum | frontend | backend | server | system | apiWhere the write originated. Defaults to 'api'. |
| is_deleted | boolean | Soft-delete flag. Excluded from default list queries. |
| deleted_at | date-time | Stamped when soft-deleted; null otherwise. |
| deleted_by | uuid | Person id who soft-deleted; null otherwise. |
| schema_version | number | Document schema version. Bumped on incompatible writes. |
| organizer_id | uuid | UUID of the Person who created or owns this event. |
| attendee_ids | json | UUIDs of Person records attending this event. |
| type | string | Classification of the event. 'ooo' = out of office, 'focus_time' = blocked for deep work. |
| title | string | Human-readable title for the event. |
| description | string | Optional description or agenda for the event. |
| start | date-time | ISO 8601 timestamp when the event starts. |
| end | date-time | ISO 8601 timestamp when the event ends. |
| is_all_day | boolean | True if the event spans the full day and has no specific time bounds. |
| location | string | Physical location or room name for the event. |
| video_url | string | URL for the video conferencing link (e.g., Zoom, Google Meet, Teams). |
| linked_project_id | uuid | UUID of the Project this event is associated with. |
| linked_task_ids | json | UUIDs of Task records discussed or actioned in this event. |
| status | string | Attendance or booking status for the event. |
API
client.employee.calendarEvents.*Loading manifest…