Schedules

Update a schedule

Changed on

Replaces the schedule. Send the full schedule body; fields that are omitted are not preserved from the existing schedule.

patch/v1/schedules/{scheduleId}

Request

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

Path parameters

scheduleIdstring required
Example:sched_123

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 updated 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