Schedule Items

List schedule items

GET/v1/teams/{teamId}/days/{dayId}/schedule-items

Lists general schedule items, drives, and flights for a day.

Required scopes: schedule_item:read

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`query.limit`	`integer` Maximum number of records to return. Defaults to 50 and is capped at 200.
`query.cursor`	`string` Cursor returned by page.nextCursor from the previous list response.

Response 200

`data`	`object[]`
`data[].dayId`	`string:uuid` Day that owns the schedule item.
`data[].name`	`string` Schedule item display name.
`data[].type`	`"general" \| "drive" \| "flight"` Schedule item variant. This must match details.kind.
`data[].status`	`"confirmed" \| "unconfirmed"` Confirmation state for the schedule item.
`data[].priority`	`"normal" \| "high"` Priority used to draw attention to important schedule items.
`data[].startTime`	`string` Schedule item start time as a UTC ISO 8601 timestamp, including the trailing Z UTC designator. The timestamp must be within 48 hours of the beginning of the associated day.
`data[].endTime`	`string` Schedule item end time as a UTC ISO 8601 timestamp, including the trailing Z UTC designator. The timestamp must be within 48 hours of the beginning of the associated day.
`data[].startTimezone`	`object` IANA timezone identifier for displaying the start time, such as America/Chicago.
`data[].endTimezone`	`object` IANA timezone identifier for displaying the end time, such as America/Chicago.
`data[].details`	`general \| drive \| flight`
`data[].details.kind`	`"general" \| "drive" \| "flight"` general: Discriminator for a general schedule item. drive: Discriminator for a drive schedule item. flight: Discriminator for a flight schedule item.
`data[].details.location`	`object` Optional location for the general item.
`data[].details.location.label`	`string` Human-readable place label.
`data[].details.location.address`	`string` Street address or venue address.
`data[].details.location.placeId`	`string` Google Places ID when available.
`data[].details.location.latitude`	`number` Latitude in decimal degrees.
`data[].details.location.longitude`	`number` Longitude in decimal degrees.
`data[].details.location.timezone`	`object` Timezone for this location.
`data[].details.metadata`	`object` Integration-specific metadata.
`data[].details.origin`	`object` Drive origin.
`data[].details.origin.label`	`string` Human-readable place label.
`data[].details.origin.address`	`string` Street address or venue address.
`data[].details.origin.placeId`	`string` Google Places ID when available.
`data[].details.origin.latitude`	`number` Latitude in decimal degrees.
`data[].details.origin.longitude`	`number` Longitude in decimal degrees.
`data[].details.origin.timezone`	`object` Timezone for this location.
`data[].details.destination`	`object` Drive destination.
`data[].details.destination.label`	`string` Human-readable place label.
`data[].details.destination.address`	`string` Street address or venue address.
`data[].details.destination.placeId`	`string` Google Places ID when available.
`data[].details.destination.latitude`	`number` Latitude in decimal degrees.
`data[].details.destination.longitude`	`number` Longitude in decimal degrees.
`data[].details.destination.timezone`	`object` Timezone for this location.
`data[].details.distanceKm`	`number` Drive distance in kilometers.
`data[].details.distanceMiles`	`number` Drive distance in miles.
`data[].details.durationMinutes`	`number` Expected drive duration in minutes.
`data[].details.vehicle`COMING SOON	`string` Vehicle assigned to the drive. Coming soon in the RoadOps app.
`data[].details.notes`	`string` Drive-specific notes.
`data[].details.flightType`	`"commercial" \| "private"` Whether the flight is commercial or private. Required when type is "flight".
`data[].details.confirmationNumber`	`string` Booking confirmation number.
`data[].details.tailNumber`	`string` Private aircraft tail number.
`data[].details.aircraftType`	`string` Private aircraft type.
`data[].details.passengerCapacity`	`integer` Passenger capacity for the private aircraft.
`data[].details.passengers`COMING SOON	`string:uuid[]` RoadOps member IDs traveling on this flight. Coming soon in the RoadOps app.
`data[].details.connections`	`object[]` Ordered flight legs or connections. Required when type is "flight".
`data[].details.connections[].airline`	`string` Airline or operator name.
`data[].details.connections[].flightNumber`	`string` Commercial flight number or private leg identifier.
`data[].details.connections[].origin`	`object` Origin airport.
`data[].details.connections[].origin.code`	`string`
`data[].details.connections[].origin.name`	`string` Airport display name.
`data[].details.connections[].origin.address`	`string` Airport address.
`data[].details.connections[].origin.placeId`	`string` Google Places ID when available.
`data[].details.connections[].origin.terminal`	`string` Terminal label.
`data[].details.connections[].origin.gate`	`string` Gate label.
`data[].details.connections[].origin.latitude`	`number` Latitude in decimal degrees.
`data[].details.connections[].origin.longitude`	`number` Longitude in decimal degrees.
`data[].details.connections[].destination`	`object` Destination airport.
`data[].details.connections[].destination.code`	`string`
`data[].details.connections[].destination.name`	`string` Airport display name.
`data[].details.connections[].destination.address`	`string` Airport address.
`data[].details.connections[].destination.placeId`	`string` Google Places ID when available.
`data[].details.connections[].destination.terminal`	`string` Terminal label.
`data[].details.connections[].destination.gate`	`string` Gate label.
`data[].details.connections[].destination.latitude`	`number` Latitude in decimal degrees.
`data[].details.connections[].destination.longitude`	`number` Longitude in decimal degrees.
`data[].details.connections[].originFbo`	`object` Origin FBO for private flights.
`data[].details.connections[].originFbo.label`	`string` Human-readable place label.
`data[].details.connections[].originFbo.address`	`string` Street address or venue address.
`data[].details.connections[].originFbo.placeId`	`string` Google Places ID when available.
`data[].details.connections[].originFbo.latitude`	`number` Latitude in decimal degrees.
`data[].details.connections[].originFbo.longitude`	`number` Longitude in decimal degrees.
`data[].details.connections[].originFbo.timezone`	`object` Timezone for this location.
`data[].details.connections[].originFboPhone`	`string` Origin FBO phone number.
`data[].details.connections[].destinationFbo`	`object` Destination FBO for private flights.
`data[].details.connections[].destinationFbo.label`	`string` Human-readable place label.
`data[].details.connections[].destinationFbo.address`	`string` Street address or venue address.
`data[].details.connections[].destinationFbo.placeId`	`string` Google Places ID when available.
`data[].details.connections[].destinationFbo.latitude`	`number` Latitude in decimal degrees.
`data[].details.connections[].destinationFbo.longitude`	`number` Longitude in decimal degrees.
`data[].details.connections[].destinationFbo.timezone`	`object` Timezone for this location.
`data[].details.connections[].destinationFboPhone`	`string` Destination FBO phone number.
`data[].details.connections[].departureTime`	`string` Scheduled departure time.
`data[].details.connections[].departureTimezone`	`object` Timezone for the departure time.
`data[].details.connections[].arrivalTime`	`string` Scheduled arrival time.
`data[].details.connections[].arrivalTimezone`	`object` Timezone for the arrival time.
`data[].notes`	`string` Optional schedule item notes.
`data[].color`	`string` Hex color reference for the schedule item label, formatted as a leading # followed by six hexadecimal characters. Use this to color-code the item consistently in calendars, timelines, and schedule views.
`data[].sourceMetadata`	`object` Integration-specific source metadata.
`data[].visibility`	`object` Optional visibility rules.
`data[].visibility.groupIds`	`string:uuid[]`
`data[].visibility.userIds`	`string:uuid[]`
`data[].id`	`string:uuid` Schedule item identifier.
`data[].orgId`	`string:uuid` Team identifier.
`data[].isDeleted`	`boolean` Soft-delete flag.
`data[].version`	`integer` Current schedule item aggregate version.
`data[].cursor`	`integer` Latest event-ledger cursor projected into this schedule item record.
`page`	`object`
`page.limit`	`integer` Maximum number of records returned in this page.
`page.nextCursor`	`string \| null` Cursor to pass as the next request's cursor query parameter, or null when there are no more results.
`meta`	`object`
`meta.cursor`	`number \| null` Highest record cursor represented by this response.

Response: List schedule items

{
  "data": [
    {
      "id": "00000000-0000-4000-8000-000000000301",
      "dayId": "00000000-0000-4000-8000-000000000201",
      "name": "Load in",
      "type": "general",
      "status": "confirmed",
      "priority": "normal",
      "startTime": "2026-09-14T15:00:00.000Z",
      "endTime": "2026-09-14T16:00:00.000Z",
      "startTimezone": "America/Chicago",
      "endTimezone": "America/Chicago",
      "details": {
        "kind": "general",
        "location": {
          "label": "Loading dock"
        }
      },
      "notes": "Stage door is off 5th Avenue.",
      "orgId": "00000000-0000-4000-8000-000000000100",
      "isDeleted": false,
      "version": 1,
      "cursor": 87234
    }
  ],
  "page": {
    "limit": 50,
    "nextCursor": null
  },
  "meta": {
    "cursor": 87234
  }
}

Create a general schedule item

POST/v1/teams/{teamId}/days/{dayId}/schedule-items

Accepts a command to create a general schedule item. Use `type: "general"` with `details.kind: "general"`.

Required scopes: schedule_item:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

Request body (application/json)

`dayId`required	`string:uuid` Day that owns the schedule item.
`name`required	`string` Schedule item display name.
`type`required	`"general"` General schedule item type.
`status`required	`"confirmed" \| "unconfirmed"` Confirmation state for the schedule item.
`priority`required	`"normal" \| "high"` Priority used to draw attention to important schedule items.
`startTime`required	`string` Schedule item start time as a UTC ISO 8601 timestamp, including the trailing Z UTC designator. The timestamp must be within 48 hours of the beginning of the associated day.
`endTime`required	`string` Schedule item end time as a UTC ISO 8601 timestamp, including the trailing Z UTC designator. The timestamp must be within 48 hours of the beginning of the associated day.
`startTimezone`required	`object` IANA timezone identifier for displaying the start time, such as America/Chicago.
`endTimezone`required	`object` IANA timezone identifier for displaying the end time, such as America/Chicago.
`details`required	`object`
`details.kind`required	`"general"` Discriminator for a general schedule item.
`details.location`	`object` Optional location for the general item.
`details.location.label`	`string` Human-readable place label.
`details.location.address`	`string` Street address or venue address.
`details.location.placeId`	`string` Google Places ID when available.
`details.location.latitude`	`number` Latitude in decimal degrees.
`details.location.longitude`	`number` Longitude in decimal degrees.
`details.location.timezone`	`object` Timezone for this location.
`details.metadata`	`object` Integration-specific metadata.
`notes`	`string` Optional schedule item notes.
`color`	`string` Hex color reference for the schedule item label, formatted as a leading # followed by six hexadecimal characters. Use this to color-code the item consistently in calendars, timelines, and schedule views.
`sourceMetadata`	`object` Integration-specific source metadata.
`visibility`	`object` Optional visibility rules.
`visibility.groupIds`	`string:uuid[]`
`visibility.userIds`	`string:uuid[]`
`id`	`string:uuid` Optional caller-supplied schedule item ID. RoadOps generates one when omitted.

Response 202

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.

Request: Create general item

{
  "id": "00000000-0000-4000-8000-000000000301",
  "dayId": "00000000-0000-4000-8000-000000000201",
  "name": "Load in",
  "type": "general",
  "status": "confirmed",
  "priority": "normal",
  "startTime": "2026-09-14T15:00:00.000Z",
  "endTime": "2026-09-14T16:00:00.000Z",
  "startTimezone": "America/Chicago",
  "endTimezone": "America/Chicago",
  "details": {
    "kind": "general",
    "location": {
      "label": "Loading dock"
    }
  },
  "notes": "Stage door is off 5th Avenue."
}

Response: Create general item

{
  "commandId": "00000000-0000-4000-8000-000000000010",
  "resourceId": "00000000-0000-4000-8000-000000000301",
  "resourceType": "schedule_item",
  "status": "applied",
  "aggregateVersion": 2,
  "cursor": 87234,
  "links": {
    "refetch": "/v1/teams/00000000-0000-4000-8000-000000000100/days/00000000-0000-4000-8000-000000000201/schedule-items/00000000-0000-4000-8000-000000000301"
  }
}

Create a drive schedule item

POST/v1/teams/{teamId}/days/{dayId}/schedule-items

Accepts a command to create a drive schedule item. Use `type: "drive"` with `details.kind: "drive"` and drive-specific origin, destination, distance, duration, vehicle, and notes fields.

Required scopes: schedule_item:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

Request body (application/json)

`dayId`required	`string:uuid` Day that owns the schedule item.
`name`required	`string` Schedule item display name.
`type`required	`"drive"` Drive schedule item type.
`status`required	`"confirmed" \| "unconfirmed"` Confirmation state for the schedule item.
`priority`required	`"normal" \| "high"` Priority used to draw attention to important schedule items.
`startTime`required	`string` Schedule item start time as a UTC ISO 8601 timestamp, including the trailing Z UTC designator. The timestamp must be within 48 hours of the beginning of the associated day.
`endTime`required	`string` Schedule item end time as a UTC ISO 8601 timestamp, including the trailing Z UTC designator. The timestamp must be within 48 hours of the beginning of the associated day.
`startTimezone`required	`object` IANA timezone identifier for displaying the start time, such as America/Chicago.
`endTimezone`required	`object` IANA timezone identifier for displaying the end time, such as America/Chicago.
`details`required	`object`
`details.kind`required	`"drive"` Discriminator for a drive schedule item.
`details.origin`	`object` Drive origin.
`details.origin.label`	`string` Human-readable place label.
`details.origin.address`	`string` Street address or venue address.
`details.origin.placeId`	`string` Google Places ID when available.
`details.origin.latitude`	`number` Latitude in decimal degrees.
`details.origin.longitude`	`number` Longitude in decimal degrees.
`details.origin.timezone`	`object` Timezone for this location.
`details.destination`	`object` Drive destination.
`details.destination.label`	`string` Human-readable place label.
`details.destination.address`	`string` Street address or venue address.
`details.destination.placeId`	`string` Google Places ID when available.
`details.destination.latitude`	`number` Latitude in decimal degrees.
`details.destination.longitude`	`number` Longitude in decimal degrees.
`details.destination.timezone`	`object` Timezone for this location.
`details.distanceKm`	`number` Drive distance in kilometers.
`details.distanceMiles`	`number` Drive distance in miles.
`details.durationMinutes`	`number` Expected drive duration in minutes.
`details.vehicle`COMING SOON	`string` Vehicle assigned to the drive. Coming soon in the RoadOps app.
`details.notes`	`string` Drive-specific notes.
`notes`	`string` Optional schedule item notes.
`color`	`string` Hex color reference for the schedule item label, formatted as a leading # followed by six hexadecimal characters. Use this to color-code the item consistently in calendars, timelines, and schedule views.
`sourceMetadata`	`object` Integration-specific source metadata.
`visibility`	`object` Optional visibility rules.
`visibility.groupIds`	`string:uuid[]`
`visibility.userIds`	`string:uuid[]`
`id`	`string:uuid` Optional caller-supplied schedule item ID. RoadOps generates one when omitted.

Response 202

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.

Request: Create drive

{
  "id": "00000000-0000-4000-8000-000000000302",
  "dayId": "00000000-0000-4000-8000-000000000201",
  "name": "Hotel to venue",
  "type": "drive",
  "status": "confirmed",
  "priority": "normal",
  "startTime": "2026-09-14T17:00:00.000Z",
  "endTime": "2026-09-14T17:25:00.000Z",
  "startTimezone": "America/Chicago",
  "endTimezone": "America/Chicago",
  "details": {
    "kind": "drive",
    "origin": {
      "label": "Hotel",
      "address": "401 Union St, Nashville, TN",
      "timezone": "America/Chicago"
    },
    "destination": {
      "label": "Venue",
      "address": "116 Rep. John Lewis Way N, Nashville, TN",
      "timezone": "America/Chicago"
    },
    "distanceMiles": 1.2,
    "durationMinutes": 25,
    "vehicle": "Sprinter"
  }
}

Response: Create drive

{
  "commandId": "00000000-0000-4000-8000-000000000010",
  "resourceId": "00000000-0000-4000-8000-000000000302",
  "resourceType": "schedule_item",
  "status": "applied",
  "aggregateVersion": 2,
  "cursor": 87234,
  "links": {
    "refetch": "/v1/teams/00000000-0000-4000-8000-000000000100/days/00000000-0000-4000-8000-000000000201/schedule-items/00000000-0000-4000-8000-000000000302"
  }
}

Create a flight schedule item

POST/v1/teams/{teamId}/days/{dayId}/schedule-items

Accepts a command to create a flight schedule item. Use `type: "flight"` with `details.kind: "flight"` and flight-specific passenger, confirmation, aircraft, and connection fields.

Required scopes: schedule_item:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

Request body (application/json)

`dayId`required	`string:uuid` Day that owns the schedule item.
`name`required	`string` Schedule item display name.
`type`required	`"flight"` Flight schedule item type.
`status`required	`"confirmed" \| "unconfirmed"` Confirmation state for the schedule item.
`priority`required	`"normal" \| "high"` Priority used to draw attention to important schedule items.
`startTime`required	`string` Schedule item start time as a UTC ISO 8601 timestamp, including the trailing Z UTC designator. The timestamp must be within 48 hours of the beginning of the associated day.
`endTime`required	`string` Schedule item end time as a UTC ISO 8601 timestamp, including the trailing Z UTC designator. The timestamp must be within 48 hours of the beginning of the associated day.
`startTimezone`required	`object` IANA timezone identifier for displaying the start time, such as America/Chicago.
`endTimezone`required	`object` IANA timezone identifier for displaying the end time, such as America/Chicago.
`details`required	`object`
`details.kind`required	`"flight"` Discriminator for a flight schedule item.
`details.flightType`required	`"commercial" \| "private"` Whether the flight is commercial or private.
`details.confirmationNumber`	`string` Booking confirmation number.
`details.tailNumber`	`string` Private aircraft tail number.
`details.aircraftType`	`string` Private aircraft type.
`details.passengerCapacity`	`integer` Passenger capacity for the private aircraft.
`details.passengers`COMING SOON	`string:uuid[]` RoadOps member IDs traveling on this flight. Coming soon in the RoadOps app.
`details.connections`required	`object[]` Ordered flight legs or connections.
`details.connections[].airline`	`string` Airline or operator name.
`details.connections[].flightNumber`	`string` Commercial flight number or private leg identifier.
`details.connections[].origin`	`object` Origin airport.
`details.connections[].origin.code`	`string`
`details.connections[].origin.name`	`string` Airport display name.
`details.connections[].origin.address`	`string` Airport address.
`details.connections[].origin.placeId`	`string` Google Places ID when available.
`details.connections[].origin.terminal`	`string` Terminal label.
`details.connections[].origin.gate`	`string` Gate label.
`details.connections[].origin.latitude`	`number` Latitude in decimal degrees.
`details.connections[].origin.longitude`	`number` Longitude in decimal degrees.
`details.connections[].destination`	`object` Destination airport.
`details.connections[].destination.code`	`string`
`details.connections[].destination.name`	`string` Airport display name.
`details.connections[].destination.address`	`string` Airport address.
`details.connections[].destination.placeId`	`string` Google Places ID when available.
`details.connections[].destination.terminal`	`string` Terminal label.
`details.connections[].destination.gate`	`string` Gate label.
`details.connections[].destination.latitude`	`number` Latitude in decimal degrees.
`details.connections[].destination.longitude`	`number` Longitude in decimal degrees.
`details.connections[].originFbo`	`object` Origin FBO for private flights.
`details.connections[].originFbo.label`	`string` Human-readable place label.
`details.connections[].originFbo.address`	`string` Street address or venue address.
`details.connections[].originFbo.placeId`	`string` Google Places ID when available.
`details.connections[].originFbo.latitude`	`number` Latitude in decimal degrees.
`details.connections[].originFbo.longitude`	`number` Longitude in decimal degrees.
`details.connections[].originFbo.timezone`	`object` Timezone for this location.
`details.connections[].originFboPhone`	`string` Origin FBO phone number.
`details.connections[].destinationFbo`	`object` Destination FBO for private flights.
`details.connections[].destinationFbo.label`	`string` Human-readable place label.
`details.connections[].destinationFbo.address`	`string` Street address or venue address.
`details.connections[].destinationFbo.placeId`	`string` Google Places ID when available.
`details.connections[].destinationFbo.latitude`	`number` Latitude in decimal degrees.
`details.connections[].destinationFbo.longitude`	`number` Longitude in decimal degrees.
`details.connections[].destinationFbo.timezone`	`object` Timezone for this location.
`details.connections[].destinationFboPhone`	`string` Destination FBO phone number.
`details.connections[].departureTime`	`string` Scheduled departure time.
`details.connections[].departureTimezone`	`object` Timezone for the departure time.
`details.connections[].arrivalTime`	`string` Scheduled arrival time.
`details.connections[].arrivalTimezone`	`object` Timezone for the arrival time.
`notes`	`string` Optional schedule item notes.
`color`	`string` Hex color reference for the schedule item label, formatted as a leading # followed by six hexadecimal characters. Use this to color-code the item consistently in calendars, timelines, and schedule views.
`sourceMetadata`	`object` Integration-specific source metadata.
`visibility`	`object` Optional visibility rules.
`visibility.groupIds`	`string:uuid[]`
`visibility.userIds`	`string:uuid[]`
`id`	`string:uuid` Optional caller-supplied schedule item ID. RoadOps generates one when omitted.

Response 202

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.

Request: Create flight

{
  "id": "00000000-0000-4000-8000-000000000303",
  "dayId": "00000000-0000-4000-8000-000000000201",
  "name": "Flight to Nashville",
  "type": "flight",
  "status": "confirmed",
  "priority": "high",
  "startTime": "2026-09-14T13:00:00.000Z",
  "endTime": "2026-09-14T14:35:00.000Z",
  "startTimezone": "America/New_York",
  "endTimezone": "America/Chicago",
  "details": {
    "kind": "flight",
    "flightType": "commercial",
    "confirmationNumber": "ABC123",
    "passengers": [
      "00000000-0000-4000-8000-000000000401"
    ],
    "connections": [
      {
        "airline": "Delta",
        "flightNumber": "DL1234",
        "origin": {
          "code": "LGA",
          "name": "LaGuardia Airport"
        },
        "destination": {
          "code": "BNA",
          "name": "Nashville International Airport"
        },
        "departureTime": "2026-09-14T13:00:00.000Z",
        "departureTimezone": "America/New_York",
        "arrivalTime": "2026-09-14T14:35:00.000Z",
        "arrivalTimezone": "America/Chicago"
      }
    ]
  }
}

Response: Create flight

{
  "commandId": "00000000-0000-4000-8000-000000000010",
  "resourceId": "00000000-0000-4000-8000-000000000303",
  "resourceType": "schedule_item",
  "status": "applied",
  "aggregateVersion": 2,
  "cursor": 87234,
  "links": {
    "refetch": "/v1/teams/00000000-0000-4000-8000-000000000100/days/00000000-0000-4000-8000-000000000201/schedule-items/00000000-0000-4000-8000-000000000303"
  }
}

Retrieve a schedule item

GET/v1/teams/{teamId}/days/{dayId}/schedule-items/{scheduleItemId}

Returns one schedule item, drive, or flight by ID.

Required scopes: schedule_item:read

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.scheduleItemId`required	`string:uuid` Schedule item identifier.

Response 200

`data`	`object`
`data.dayId`	`string:uuid` Day that owns the schedule item.
`data.name`	`string` Schedule item display name.
`data.type`	`"general" \| "drive" \| "flight"` Schedule item variant. This must match details.kind.
`data.status`	`"confirmed" \| "unconfirmed"` Confirmation state for the schedule item.
`data.priority`	`"normal" \| "high"` Priority used to draw attention to important schedule items.
`data.startTime`	`string` Schedule item start time as a UTC ISO 8601 timestamp, including the trailing Z UTC designator. The timestamp must be within 48 hours of the beginning of the associated day.
`data.endTime`	`string` Schedule item end time as a UTC ISO 8601 timestamp, including the trailing Z UTC designator. The timestamp must be within 48 hours of the beginning of the associated day.
`data.startTimezone`	`object` IANA timezone identifier for displaying the start time, such as America/Chicago.
`data.endTimezone`	`object` IANA timezone identifier for displaying the end time, such as America/Chicago.
`data.details`	`general \| drive \| flight`
`data.details.kind`	`"general" \| "drive" \| "flight"` general: Discriminator for a general schedule item. drive: Discriminator for a drive schedule item. flight: Discriminator for a flight schedule item.
`data.details.location`	`object` Optional location for the general item.
`data.details.location.label`	`string` Human-readable place label.
`data.details.location.address`	`string` Street address or venue address.
`data.details.location.placeId`	`string` Google Places ID when available.
`data.details.location.latitude`	`number` Latitude in decimal degrees.
`data.details.location.longitude`	`number` Longitude in decimal degrees.
`data.details.location.timezone`	`object` Timezone for this location.
`data.details.metadata`	`object` Integration-specific metadata.
`data.details.origin`	`object` Drive origin.
`data.details.origin.label`	`string` Human-readable place label.
`data.details.origin.address`	`string` Street address or venue address.
`data.details.origin.placeId`	`string` Google Places ID when available.
`data.details.origin.latitude`	`number` Latitude in decimal degrees.
`data.details.origin.longitude`	`number` Longitude in decimal degrees.
`data.details.origin.timezone`	`object` Timezone for this location.
`data.details.destination`	`object` Drive destination.
`data.details.destination.label`	`string` Human-readable place label.
`data.details.destination.address`	`string` Street address or venue address.
`data.details.destination.placeId`	`string` Google Places ID when available.
`data.details.destination.latitude`	`number` Latitude in decimal degrees.
`data.details.destination.longitude`	`number` Longitude in decimal degrees.
`data.details.destination.timezone`	`object` Timezone for this location.
`data.details.distanceKm`	`number` Drive distance in kilometers.
`data.details.distanceMiles`	`number` Drive distance in miles.
`data.details.durationMinutes`	`number` Expected drive duration in minutes.
`data.details.vehicle`COMING SOON	`string` Vehicle assigned to the drive. Coming soon in the RoadOps app.
`data.details.notes`	`string` Drive-specific notes.
`data.details.flightType`	`"commercial" \| "private"` Whether the flight is commercial or private. Required when type is "flight".
`data.details.confirmationNumber`	`string` Booking confirmation number.
`data.details.tailNumber`	`string` Private aircraft tail number.
`data.details.aircraftType`	`string` Private aircraft type.
`data.details.passengerCapacity`	`integer` Passenger capacity for the private aircraft.
`data.details.passengers`COMING SOON	`string:uuid[]` RoadOps member IDs traveling on this flight. Coming soon in the RoadOps app.
`data.details.connections`	`object[]` Ordered flight legs or connections. Required when type is "flight".
`data.details.connections[].airline`	`string` Airline or operator name.
`data.details.connections[].flightNumber`	`string` Commercial flight number or private leg identifier.
`data.details.connections[].origin`	`object` Origin airport.
`data.details.connections[].origin.code`	`string`
`data.details.connections[].origin.name`	`string` Airport display name.
`data.details.connections[].origin.address`	`string` Airport address.
`data.details.connections[].origin.placeId`	`string` Google Places ID when available.
`data.details.connections[].origin.terminal`	`string` Terminal label.
`data.details.connections[].origin.gate`	`string` Gate label.
`data.details.connections[].origin.latitude`	`number` Latitude in decimal degrees.
`data.details.connections[].origin.longitude`	`number` Longitude in decimal degrees.
`data.details.connections[].destination`	`object` Destination airport.
`data.details.connections[].destination.code`	`string`
`data.details.connections[].destination.name`	`string` Airport display name.
`data.details.connections[].destination.address`	`string` Airport address.
`data.details.connections[].destination.placeId`	`string` Google Places ID when available.
`data.details.connections[].destination.terminal`	`string` Terminal label.
`data.details.connections[].destination.gate`	`string` Gate label.
`data.details.connections[].destination.latitude`	`number` Latitude in decimal degrees.
`data.details.connections[].destination.longitude`	`number` Longitude in decimal degrees.
`data.details.connections[].originFbo`	`object` Origin FBO for private flights.
`data.details.connections[].originFbo.label`	`string` Human-readable place label.
`data.details.connections[].originFbo.address`	`string` Street address or venue address.
`data.details.connections[].originFbo.placeId`	`string` Google Places ID when available.
`data.details.connections[].originFbo.latitude`	`number` Latitude in decimal degrees.
`data.details.connections[].originFbo.longitude`	`number` Longitude in decimal degrees.
`data.details.connections[].originFbo.timezone`	`object` Timezone for this location.
`data.details.connections[].originFboPhone`	`string` Origin FBO phone number.
`data.details.connections[].destinationFbo`	`object` Destination FBO for private flights.
`data.details.connections[].destinationFbo.label`	`string` Human-readable place label.
`data.details.connections[].destinationFbo.address`	`string` Street address or venue address.
`data.details.connections[].destinationFbo.placeId`	`string` Google Places ID when available.
`data.details.connections[].destinationFbo.latitude`	`number` Latitude in decimal degrees.
`data.details.connections[].destinationFbo.longitude`	`number` Longitude in decimal degrees.
`data.details.connections[].destinationFbo.timezone`	`object` Timezone for this location.
`data.details.connections[].destinationFboPhone`	`string` Destination FBO phone number.
`data.details.connections[].departureTime`	`string` Scheduled departure time.
`data.details.connections[].departureTimezone`	`object` Timezone for the departure time.
`data.details.connections[].arrivalTime`	`string` Scheduled arrival time.
`data.details.connections[].arrivalTimezone`	`object` Timezone for the arrival time.
`data.notes`	`string` Optional schedule item notes.
`data.color`	`string` Hex color reference for the schedule item label, formatted as a leading # followed by six hexadecimal characters. Use this to color-code the item consistently in calendars, timelines, and schedule views.
`data.sourceMetadata`	`object` Integration-specific source metadata.
`data.visibility`	`object` Optional visibility rules.
`data.visibility.groupIds`	`string:uuid[]`
`data.visibility.userIds`	`string:uuid[]`
`data.id`	`string:uuid` Schedule item identifier.
`data.orgId`	`string:uuid` Team identifier.
`data.isDeleted`	`boolean` Soft-delete flag.
`data.version`	`integer` Current schedule item aggregate version.
`data.cursor`	`integer` Latest event-ledger cursor projected into this schedule item record.
`meta`	`object`
`meta.cursor`	`integer` Highest record cursor represented by this response.

Reschedule a schedule item

POST/v1/teams/{teamId}/days/{dayId}/schedule-items/{scheduleItemId}/reschedule

Moves a schedule item to new start and end times. Use this endpoint specifically for time changes rather than general schedule item edits. If the move changes an item occurring within a user's 24h or 48h schedule notice window, RoadOps sends push notifications to users who have schedule notifications enabled.

Required scopes: schedule_item:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.scheduleItemId`required	`string:uuid` Schedule item identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

Request body (application/json)

`expectedVersion`	`integer` Optional aggregate version guard.
`startTime`required	`string:date-time` New start time as a UTC ISO 8601 timestamp, including the trailing Z UTC designator. The timestamp must be within 48 hours of the beginning of the associated day.
`endTime`required	`string:date-time` New end time as a UTC ISO 8601 timestamp, including the trailing Z UTC designator. The timestamp must be within 48 hours of the beginning of the associated day.
`startTimezone`required	`object` IANA timezone identifier for displaying the new start time, such as America/Chicago.
`endTimezone`required	`object` IANA timezone identifier for displaying the new end time, such as America/Chicago.

Response 202

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.

Update a schedule item

PATCH/v1/teams/{teamId}/days/{dayId}/schedule-items/{scheduleItemId}

Accepts a command to update a general schedule item, drive, or flight.

Required scopes: schedule_item:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.scheduleItemId`required	`string:uuid` Schedule item identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

Request body (application/json)

`expectedVersion`	`integer` Optional aggregate version guard.
`updates`required	`object` Schedule item fields to update. The type field must continue to match details.kind when both are supplied.
`updates.dayId`	`string:uuid` Day that owns the schedule item.
`updates.name`	`string` Schedule item display name.
`updates.type`	`"general" \| "drive" \| "flight"` Schedule item variant. This must match details.kind.
`updates.status`	`"confirmed" \| "unconfirmed"` Confirmation state for the schedule item.
`updates.priority`	`"normal" \| "high"` Priority used to draw attention to important schedule items.
`updates.startTime`	`string` Schedule item start time as a UTC ISO 8601 timestamp, including the trailing Z UTC designator. The timestamp must be within 48 hours of the beginning of the associated day.
`updates.endTime`	`string` Schedule item end time as a UTC ISO 8601 timestamp, including the trailing Z UTC designator. The timestamp must be within 48 hours of the beginning of the associated day.
`updates.startTimezone`	`object` IANA timezone identifier for displaying the start time, such as America/Chicago.
`updates.endTimezone`	`object` IANA timezone identifier for displaying the end time, such as America/Chicago.
`updates.details`	`general \| drive \| flight`
`updates.details.kind`required	`"general" \| "drive" \| "flight"` general: Discriminator for a general schedule item. drive: Discriminator for a drive schedule item. flight: Discriminator for a flight schedule item.
`updates.details.location`	`object` Optional location for the general item.
`updates.details.location.label`	`string` Human-readable place label.
`updates.details.location.address`	`string` Street address or venue address.
`updates.details.location.placeId`	`string` Google Places ID when available.
`updates.details.location.latitude`	`number` Latitude in decimal degrees.
`updates.details.location.longitude`	`number` Longitude in decimal degrees.
`updates.details.location.timezone`	`object` Timezone for this location.
`updates.details.metadata`	`object` Integration-specific metadata.
`updates.details.origin`	`object` Drive origin.
`updates.details.origin.label`	`string` Human-readable place label.
`updates.details.origin.address`	`string` Street address or venue address.
`updates.details.origin.placeId`	`string` Google Places ID when available.
`updates.details.origin.latitude`	`number` Latitude in decimal degrees.
`updates.details.origin.longitude`	`number` Longitude in decimal degrees.
`updates.details.origin.timezone`	`object` Timezone for this location.
`updates.details.destination`	`object` Drive destination.
`updates.details.destination.label`	`string` Human-readable place label.
`updates.details.destination.address`	`string` Street address or venue address.
`updates.details.destination.placeId`	`string` Google Places ID when available.
`updates.details.destination.latitude`	`number` Latitude in decimal degrees.
`updates.details.destination.longitude`	`number` Longitude in decimal degrees.
`updates.details.destination.timezone`	`object` Timezone for this location.
`updates.details.distanceKm`	`number` Drive distance in kilometers.
`updates.details.distanceMiles`	`number` Drive distance in miles.
`updates.details.durationMinutes`	`number` Expected drive duration in minutes.
`updates.details.vehicle`COMING SOON	`string` Vehicle assigned to the drive. Coming soon in the RoadOps app.
`updates.details.notes`	`string` Drive-specific notes.
`updates.details.flightType`	`"commercial" \| "private"` Whether the flight is commercial or private. Required when type is "flight".
`updates.details.confirmationNumber`	`string` Booking confirmation number.
`updates.details.tailNumber`	`string` Private aircraft tail number.
`updates.details.aircraftType`	`string` Private aircraft type.
`updates.details.passengerCapacity`	`integer` Passenger capacity for the private aircraft.
`updates.details.passengers`COMING SOON	`string:uuid[]` RoadOps member IDs traveling on this flight. Coming soon in the RoadOps app.
`updates.details.connections`	`object[]` Ordered flight legs or connections. Required when type is "flight".
`updates.details.connections[].airline`	`string` Airline or operator name.
`updates.details.connections[].flightNumber`	`string` Commercial flight number or private leg identifier.
`updates.details.connections[].origin`	`object` Origin airport.
`updates.details.connections[].origin.code`	`string`
`updates.details.connections[].origin.name`	`string` Airport display name.
`updates.details.connections[].origin.address`	`string` Airport address.
`updates.details.connections[].origin.placeId`	`string` Google Places ID when available.
`updates.details.connections[].origin.terminal`	`string` Terminal label.
`updates.details.connections[].origin.gate`	`string` Gate label.
`updates.details.connections[].origin.latitude`	`number` Latitude in decimal degrees.
`updates.details.connections[].origin.longitude`	`number` Longitude in decimal degrees.
`updates.details.connections[].destination`	`object` Destination airport.
`updates.details.connections[].destination.code`	`string`
`updates.details.connections[].destination.name`	`string` Airport display name.
`updates.details.connections[].destination.address`	`string` Airport address.
`updates.details.connections[].destination.placeId`	`string` Google Places ID when available.
`updates.details.connections[].destination.terminal`	`string` Terminal label.
`updates.details.connections[].destination.gate`	`string` Gate label.
`updates.details.connections[].destination.latitude`	`number` Latitude in decimal degrees.
`updates.details.connections[].destination.longitude`	`number` Longitude in decimal degrees.
`updates.details.connections[].originFbo`	`object` Origin FBO for private flights.
`updates.details.connections[].originFbo.label`	`string` Human-readable place label.
`updates.details.connections[].originFbo.address`	`string` Street address or venue address.
`updates.details.connections[].originFbo.placeId`	`string` Google Places ID when available.
`updates.details.connections[].originFbo.latitude`	`number` Latitude in decimal degrees.
`updates.details.connections[].originFbo.longitude`	`number` Longitude in decimal degrees.
`updates.details.connections[].originFbo.timezone`	`object` Timezone for this location.
`updates.details.connections[].originFboPhone`	`string` Origin FBO phone number.
`updates.details.connections[].destinationFbo`	`object` Destination FBO for private flights.
`updates.details.connections[].destinationFbo.label`	`string` Human-readable place label.
`updates.details.connections[].destinationFbo.address`	`string` Street address or venue address.
`updates.details.connections[].destinationFbo.placeId`	`string` Google Places ID when available.
`updates.details.connections[].destinationFbo.latitude`	`number` Latitude in decimal degrees.
`updates.details.connections[].destinationFbo.longitude`	`number` Longitude in decimal degrees.
`updates.details.connections[].destinationFbo.timezone`	`object` Timezone for this location.
`updates.details.connections[].destinationFboPhone`	`string` Destination FBO phone number.
`updates.details.connections[].departureTime`	`string` Scheduled departure time.
`updates.details.connections[].departureTimezone`	`object` Timezone for the departure time.
`updates.details.connections[].arrivalTime`	`string` Scheduled arrival time.
`updates.details.connections[].arrivalTimezone`	`object` Timezone for the arrival time.
`updates.notes`	`string` Optional schedule item notes.
`updates.color`	`string` Hex color reference for the schedule item label, formatted as a leading # followed by six hexadecimal characters. Use this to color-code the item consistently in calendars, timelines, and schedule views.
`updates.sourceMetadata`	`object` Integration-specific source metadata.
`updates.visibility`	`object` Optional visibility rules.
`updates.visibility.groupIds`	`string:uuid[]`
`updates.visibility.userIds`	`string:uuid[]`

Response 202

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.

Request: Update general item

{
  "updates": {
    "notes": "Use stage-left entrance."
  }
}

Request: Update drive

{
  "updates": {
    "details": {
      "kind": "drive",
      "origin": {
        "label": "Hotel",
        "address": "401 Union St, Nashville, TN",
        "timezone": "America/Chicago"
      },
      "destination": {
        "label": "Venue",
        "address": "116 Rep. John Lewis Way N, Nashville, TN",
        "timezone": "America/Chicago"
      },
      "distanceMiles": 1.2,
      "durationMinutes": 25,
      "vehicle": "SUV"
    }
  }
}

Request: Update flight

{
  "updates": {
    "details": {
      "kind": "flight",
      "flightType": "commercial",
      "confirmationNumber": "XYZ789",
      "passengers": [
        "00000000-0000-4000-8000-000000000401"
      ],
      "connections": [
        {
          "airline": "Delta",
          "flightNumber": "DL1234",
          "origin": {
            "code": "LGA",
            "name": "LaGuardia Airport"
          },
          "destination": {
            "code": "BNA",
            "name": "Nashville International Airport"
          },
          "departureTime": "2026-09-14T13:00:00.000Z",
          "departureTimezone": "America/New_York",
          "arrivalTime": "2026-09-14T14:35:00.000Z",
          "arrivalTimezone": "America/Chicago"
        }
      ]
    }
  }
}

Response: Update general item

{
  "commandId": "00000000-0000-4000-8000-000000000010",
  "resourceId": "00000000-0000-4000-8000-000000000301",
  "resourceType": "schedule_item",
  "status": "applied",
  "aggregateVersion": 2,
  "cursor": 87234,
  "links": {
    "refetch": "/v1/teams/00000000-0000-4000-8000-000000000100/days/00000000-0000-4000-8000-000000000201/schedule-items/00000000-0000-4000-8000-000000000301"
  }
}

Response: Update drive

{
  "commandId": "00000000-0000-4000-8000-000000000010",
  "resourceId": "00000000-0000-4000-8000-000000000302",
  "resourceType": "schedule_item",
  "status": "applied",
  "aggregateVersion": 2,
  "cursor": 87234,
  "links": {
    "refetch": "/v1/teams/00000000-0000-4000-8000-000000000100/days/00000000-0000-4000-8000-000000000201/schedule-items/00000000-0000-4000-8000-000000000302"
  }
}

Response: Update flight

{
  "commandId": "00000000-0000-4000-8000-000000000010",
  "resourceId": "00000000-0000-4000-8000-000000000303",
  "resourceType": "schedule_item",
  "status": "applied",
  "aggregateVersion": 2,
  "cursor": 87234,
  "links": {
    "refetch": "/v1/teams/00000000-0000-4000-8000-000000000100/days/00000000-0000-4000-8000-000000000201/schedule-items/00000000-0000-4000-8000-000000000303"
  }
}

Delete a schedule item

DELETE/v1/teams/{teamId}/days/{dayId}/schedule-items/{scheduleItemId}

Accepts a command to delete a schedule item, drive, or flight.

Required scopes: schedule_item:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.scheduleItemId`required	`string:uuid` Schedule item identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

Response 202

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.