Schedules

Create a schedule

Changed on

Creates a recurring schedule that generates one content type from the selected GitHub integrations. Times are in UTC. A schedule with the same source, targets, output, and lookback settings as an existing one is rejected with 409.

post/v1/schedules

Request

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

Request body

namestring required

Display name shown in the dashboard.

sourceType'cron' required

Always cron for schedules.

outputType'changelog' | 'blog_post' | 'linkedin_post' | 'twitter_post' | 'image' required

Type of content each run generates.

enabledboolean required

Whether the schedule runs. Disabled schedules are stored but never fire.

autoPublishboolean

Publish generated posts automatically instead of saving them as drafts.

lookbackWindow'current_day' | 'yesterday' | 'last_7_days' | 'last_14_days' | 'last_30_days'

How far back each run collects source activity.

Example request

{
  "name": "Weekly changelog",
  "sourceConfig": {
    "cron": {
      "frequency": "weekly",
      "hour": 9,
      "dayOfWeek": 1,
      "dayOfMonth": 1,
      "intervalDays": 3,
      "anchorDate": "2026-09-03"
    }
  },
  "targets": {
    "repositoryIds": [
      "51c2f3aa-efdd-4e28-8e69-23fa2dfd3561"
    ]
  },
  "outputType": "changelog",
  "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."
  },
  "enabled": true,
  "lookbackWindow": "last_7_days"
}

Response

Schedule created successfully

Example response

{
  "schedule": {
    "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 new optional request property /

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new custom enum value to the request property //

    • 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