RoadOps Developer Docs

List day notes

GET/v1/teams/{teamId}/days/{dayId}/notes

Lists notes for a day.

Required scopes: day_note: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`
`data[].title`	`string`
`data[].body`	`string` Day note body. New lines are represented with \n characters, and basic Markdown formatting is supported.
`data[].visibility`	`object`
`data[].visibility.groupIds`	`string:uuid[]`
`data[].visibility.userIds`	`string:uuid[]`
`data[].id`	`string:uuid`
`data[].orgId`	`string:uuid`
`data[].isDeleted`	`boolean`
`data[].version`	`integer` Current day note aggregate version.
`data[].createdAt`	`string:date-time` ISO 8601 timestamp when the day note was created.
`data[].createdBy`	`string` User identifier that created the day note.
`data[].updatedAt`	`string:date-time` ISO 8601 timestamp when the day note was last updated.
`data[].updatedBy`	`string` User identifier that last updated the day note.
`data[].deletedAt`	`string:date-time` ISO 8601 timestamp when the day note was deleted.
`data[].cursor`	`integer` Latest event-ledger cursor projected into this day note 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 day notes

{
  "data": [
    {
      "id": "00000000-0000-4000-8000-000000000971",
      "title": "Security",
      "body": "**Security note**\n\nUse the stage-left entrance after 6 PM.\nBring your badge.",
      "visibility": {
        "userIds": [
          "00000000-0000-4000-8000-000000000101"
        ]
      },
      "orgId": "00000000-0000-4000-8000-000000000100",
      "dayId": "00000000-0000-4000-8000-000000000201",
      "isDeleted": false,
      "createdBy": "00000000-0000-4000-8000-000000000101",
      "createdAt": "2026-09-01T12:00:00.000Z",
      "updatedBy": "00000000-0000-4000-8000-000000000101",
      "updatedAt": "2026-09-01T12:00:00.000Z",
      "version": 1,
      "cursor": 87234
    }
  ],
  "page": {
    "limit": 50,
    "nextCursor": null
  },
  "meta": {
    "cursor": 87234
  }
}

Create a day note

POST/v1/teams/{teamId}/days/{dayId}/notes

Accepts a command to create a day note.

Required scopes: day_note: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)

`title`	`string`
`body`required	`string` Day note body. New lines are represented with \n characters, and basic Markdown formatting is supported.
`visibility`	`object`
`visibility.groupIds`	`string:uuid[]`
`visibility.userIds`	`string:uuid[]`
`id`	`string:uuid` Optional caller-supplied day note 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.

Retrieve a day note

GET/v1/teams/{teamId}/days/{dayId}/notes/{noteId}

Returns one day note by ID.

Required scopes: day_note:read

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.noteId`required	`string:uuid` Day note identifier.

Response 200

`data`	`object`
`data.dayId`	`string:uuid`
`data.title`	`string`
`data.body`	`string` Day note body. New lines are represented with \n characters, and basic Markdown formatting is supported.
`data.visibility`	`object`
`data.visibility.groupIds`	`string:uuid[]`
`data.visibility.userIds`	`string:uuid[]`
`data.id`	`string:uuid`
`data.orgId`	`string:uuid`
`data.isDeleted`	`boolean`
`data.version`	`integer` Current day note aggregate version.
`data.createdAt`	`string:date-time` ISO 8601 timestamp when the day note was created.
`data.createdBy`	`string` User identifier that created the day note.
`data.updatedAt`	`string:date-time` ISO 8601 timestamp when the day note was last updated.
`data.updatedBy`	`string` User identifier that last updated the day note.
`data.deletedAt`	`string:date-time` ISO 8601 timestamp when the day note was deleted.
`data.cursor`	`integer` Latest event-ledger cursor projected into this day note record.
`meta`	`object`
`meta.cursor`	`integer` Highest record cursor represented by this response.

Update a day note

PATCH/v1/teams/{teamId}/days/{dayId}/notes/{noteId}

Accepts a command to update day note fields.

Required scopes: day_note:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.noteId`required	`string:uuid` Day note 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` Day note fields to update.
`updates.title`	`string \| null` Updated note title, or null to clear it.
`updates.body`	`string` Updated note body. New lines are represented with \n characters, and basic Markdown formatting is supported.
`updates.visibility`	`object \| null` Updated visibility, or null to clear custom visibility.
`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.

Delete a day note

DELETE/v1/teams/{teamId}/days/{dayId}/notes/{noteId}

Accepts a command to delete a day note.

Required scopes: day_note:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.dayId`required	`string:uuid` Day identifier.
`path.noteId`required	`string:uuid` Day note 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.

Day Notes

List day notes

Parameters

Response 200

Create a day note

Parameters

Request body (application/json)

Response 202

Retrieve a day note

Parameters

Response 200

Update a day note

Parameters

Request body (application/json)

Response 202

Delete a day note

Parameters

Response 202