Schedules

List schedules

Changed on

Returns the organization's cron schedules, newest first. repositoryMap maps each targeted GitHub integration ID to an owner/repo label.

get/v1/schedules

Request

  • Base URL: https://api.usenotra.com
  • URL: https://api.usenotra.com/v1/schedules
  • Auth: HTTP bearer

Query parameters

repositoryIdsstring

Filter by GitHub integration IDs using a comma-separated list. Only schedules targeting at least one of them are returned.

Example:51c2f3aa-efdd-4e28-8e69-23fa2dfd3561,7f9a2b3c-1d4e-4f5a-9b6c-8d7e6f5a4b3c

Response

Schedules fetched successfully

repositoryMapobject required

Example response

{
  "schedules": [
    {
      "sourceConfig": {
        "cron": {
          "frequency": "weekly",
          "hour": 9,
          "dayOfWeek": 1,
          "dayOfMonth": 1,
          "intervalDays": 3,
          "anchorDate": "2026-09-03"
        }
      },
      "targets": {
        "repositoryIds": [
          "51c2f3aa-efdd-4e28-8e69-23fa2dfd3561"
        ]
      },
      "outputConfig": {
        "brandVoiceId": "51c2f3aa-efdd-4e28-8e69-23fa2dfd3561",
        "instructions": "Write a tutorial-style post that walks through one feature shipped in this window, with code samples."
      }
    }
  ]
}

Changes

  • 931a7bd8d32cRevision changes
    • warning

      added the new custom enum value to the //// response property for the response status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status