v1

latestOpenAPI 3.0.3MIT2026-07-1411163326.7 KB
Schedule

Get a schedule by ID. Available only on schedules associated with GitHub OAuth or Bitbucket Cloud pipeline definitions.

Get a schedule by id.

get/schedule/{schedule-id}

Path parameters

schedule-idstring uuid required

The unique ID of the schedule.

Response

A schedule object.

idstring uuid required

The unique ID of the schedule.

updated-atstring date-time required

The date and time the pipeline was last updated.

namestring required

Name of the schedule.

created-atstring date-time required

The date and time the pipeline was created.

project-slugstring required

The project-slug for the schedule

parametersobject required

Pipeline parameters represented as key-value pairs. Must contain branch or tag.

descriptionstring required

Description of the schedule.

Example response

{
  "project-slug": "gh/CircleCI-Public/api-preview-docs",
  "parameters": {
    "deploy_prod": true,
    "branch": "feature/design-new-api"
  }
}