Operations about pipeline_schedules
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/gitlab-ci-pipeline-schedules-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: GitLab access_requests Pipeline Schedules API
version: v4
description: Operations related to access requests
servers:
- url: https://gitlab.com
tags:
- name: pipeline_schedules
description: Operations about pipeline_schedules
paths:
/api/v4/projects/{id}/pipeline_schedules:
get:
description: Get all pipeline schedules
parameters:
- in: path
name: id
description: The ID or URL-encoded path of the project
required: true
example: 18
schema:
type: string
- in: query
name: page
description: Current page number
required: false
example: 1
schema:
type: integer
format: int32
default: 1
- in: query
name: per_page
description: Number of items per page
required: false
example: 20
schema:
type: integer
format: int32
default: 20
- in: query
name: scope
description: The scope of pipeline schedules
required: false
example: active
schema:
type: string
enum:
- active
- inactive
responses:
'200':
description: Get all pipeline schedules
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/API_Entities_Ci_PipelineSchedule'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not found
tags:
- pipeline_schedules
operationId: getApiV4ProjectsIdPipelineSchedules
post:
description: Create a new pipeline schedule
parameters:
- in: path
name: id
description: The ID or URL-encoded path of the project
required: true
example: 18
schema:
type: string
responses:
'201':
description: Create a new pipeline schedule
content:
application/json:
schema:
$ref: '#/components/schemas/API_Entities_Ci_PipelineScheduleDetails'
'400':
description: Bad request
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not found
tags:
- pipeline_schedules
operationId: postApiV4ProjectsIdPipelineSchedules
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/postApiV4ProjectsIdPipelineSchedules'
required: true
/api/v4/projects/{id}/pipeline_schedules/{pipeline_schedule_id}:
get:
description: Get a single pipeline schedule
parameters:
- in: path
name: id
description: The ID or URL-encoded path of the project
required: true
example: 18
schema:
type: string
- in: path
name: pipeline_schedule_id
description: The pipeline schedule id
required: true
example: 13
schema:
type: integer
format: int32
responses:
'200':
description: Get a single pipeline schedule
content:
application/json:
schema:
$ref: '#/components/schemas/API_Entities_Ci_PipelineScheduleDetails'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not found
tags:
- pipeline_schedules
operationId: getApiV4ProjectsIdPipelineSchedulesPipelineScheduleId
put:
description: Edit a pipeline schedule
parameters:
- in: path
name: id
description: The ID or URL-encoded path of the project
required: true
example: 18
schema:
type: string
- in: path
name: pipeline_schedule_id
description: The pipeline schedule id
required: true
example: 13
schema:
type: integer
format: int32
responses:
'200':
description: Edit a pipeline schedule
content:
application/json:
schema:
$ref: '#/components/schemas/API_Entities_Ci_PipelineScheduleDetails'
'400':
description: Bad request
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not found
tags:
- pipeline_schedules
operationId: putApiV4ProjectsIdPipelineSchedulesPipelineScheduleId
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/putApiV4ProjectsIdPipelineSchedulesPipelineScheduleId'
required: true
delete:
description: Delete a pipeline schedule
parameters:
- in: path
name: id
description: The ID or URL-encoded path of the project
required: true
example: 18
schema:
type: string
- in: path
name: pipeline_schedule_id
description: The pipeline schedule id
required: true
example: 13
schema:
type: integer
format: int32
responses:
'204':
description: Delete a pipeline schedule
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not found
'412':
description: Precondition Failed
tags:
- pipeline_schedules
operationId: deleteApiV4ProjectsIdPipelineSchedulesPipelineScheduleId
/api/v4/projects/{id}/pipeline_schedules/{pipeline_schedule_id}/pipelines:
get:
description: Get all pipelines triggered from a pipeline schedule
parameters:
- in: path
name: id
description: The ID or URL-encoded path of the project
required: true
example: 18
schema:
type: string
- in: query
name: page
description: Current page number
required: false
example: 1
schema:
type: integer
format: int32
default: 1
- in: query
name: per_page
description: Number of items per page
required: false
example: 20
schema:
type: integer
format: int32
default: 20
- in: path
name: pipeline_schedule_id
description: The pipeline schedule ID
required: true
example: 13
schema:
type: integer
format: int32
- in: query
name: scope
description: The scope of pipelines
required: false
example: pending
schema:
type: string
enum:
- running
- pending
- finished
- branches
- tags
- in: query
name: status
description: The status of pipelines
required: false
example: pending
schema:
type: string
enum:
- created
- waiting_for_resource
- preparing
- waiting_for_callback
- pending
- running
- success
- failed
- canceling
- canceled
- skipped
- manual
- scheduled
- in: query
name: updated_before
description: 'Return pipelines updated before the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ'
required: false
example: '2015-12-24T15:51:21.880Z'
schema:
type: string
format: date-time
- in: query
name: updated_after
description: 'Return pipelines updated after the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ'
required: false
example: '2015-12-24T15:51:21.880Z'
schema:
type: string
format: date-time
- in: query
name: created_before
description: 'Return pipelines created before the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ'
required: false
example: '2015-12-24T15:51:21.880Z'
schema:
type: string
format: date-time
- in: query
name: created_after
description: 'Return pipelines created after the specified datetime. Format: ISO 8601 YYYY-MM-DDTHH:MM:SSZ'
required: false
example: '2015-12-24T15:51:21.880Z'
schema:
type: string
format: date-time
- in: query
name: sort
description: Sort pipelines
required: false
example: desc
schema:
type: string
enum:
- asc
- desc
default: asc
responses:
'200':
description: Get all pipelines triggered from a pipeline schedule
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/API_Entities_Ci_PipelineBasic'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not found
tags:
- pipeline_schedules
operationId: getApiV4ProjectsIdPipelineSchedulesPipelineScheduleIdPipelines
/api/v4/projects/{id}/pipeline_schedules/{pipeline_schedule_id}/take_ownership:
post:
description: Take ownership of a pipeline schedule
parameters:
- in: path
name: id
description: The ID or URL-encoded path of the project
required: true
example: 18
schema:
type: string
- in: path
name: pipeline_schedule_id
description: The pipeline schedule id
required: true
example: 13
schema:
type: integer
format: int32
responses:
'201':
description: Take ownership of a pipeline schedule
content:
application/json:
schema:
$ref: '#/components/schemas/API_Entities_Ci_PipelineScheduleDetails'
'400':
description: Bad request
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not found
tags:
- pipeline_schedules
operationId: postApiV4ProjectsIdPipelineSchedulesPipelineScheduleIdTakeOwnership
/api/v4/projects/{id}/pipeline_schedules/{pipeline_schedule_id}/play:
post:
summary: Play a scheduled pipeline immediately
description: This feature was added in GitLab 12.8
parameters:
- in: path
name: id
description: The ID or URL-encoded path of the project
required: true
example: 18
schema:
type: string
- in: path
name: pipeline_schedule_id
description: The pipeline schedule id
required: true
example: 13
schema:
type: integer
format: int32
responses:
'201':
description: Play a scheduled pipeline immediately
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not found
tags:
- pipeline_schedules
operationId: postApiV4ProjectsIdPipelineSchedulesPipelineScheduleIdPlay
/api/v4/projects/{id}/pipeline_schedules/{pipeline_schedule_id}/variables:
post:
description: Create a new pipeline schedule variable
parameters:
- in: path
name: id
description: The ID or URL-encoded path of the project
required: true
example: 18
schema:
type: string
- in: path
name: pipeline_schedule_id
description: The pipeline schedule id
required: true
example: 13
schema:
type: integer
format: int32
responses:
'201':
description: Create a new pipeline schedule variable
content:
application/json:
schema:
$ref: '#/components/schemas/API_Entities_Ci_Variable'
'400':
description: Bad request
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not found
tags:
- pipeline_schedules
operationId: postApiV4ProjectsIdPipelineSchedulesPipelineScheduleIdVariables
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/postApiV4ProjectsIdPipelineSchedulesPipelineScheduleIdVariables'
required: true
/api/v4/projects/{id}/pipeline_schedules/{pipeline_schedule_id}/variables/{key}:
get:
description: Get a single pipeline schedule variable
parameters:
- in: path
name: id
description: The ID or URL-encoded path of the project
required: true
example: 18
schema:
type: string
- in: path
name: pipeline_schedule_id
description: The pipeline schedule id
required: true
example: 13
schema:
type: integer
format: int32
- in: path
name: key
description: The key of the variable
required: true
example: NEW_VARIABLE
schema:
type: string
responses:
'200':
description: Get a single pipeline schedule variable
content:
application/json:
schema:
$ref: '#/components/schemas/API_Entities_Ci_Variable'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not found
tags:
- pipeline_schedules
operationId: getApiV4ProjectsIdPipelineSchedulesPipelineScheduleIdVariablesKey
put:
description: Edit a pipeline schedule variable
parameters:
- in: path
name: id
description: The ID or URL-encoded path of the project
required: true
example: 18
schema:
type: string
- in: path
name: pipeline_schedule_id
description: The pipeline schedule id
required: true
example: 13
schema:
type: integer
format: int32
- in: path
name: key
description: The key of the variable
required: true
example: NEW_VARIABLE
schema:
type: string
responses:
'200':
description: Edit a pipeline schedule variable
content:
application/json:
schema:
$ref: '#/components/schemas/API_Entities_Ci_Variable'
'400':
description: Bad request
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not found
tags:
- pipeline_schedules
operationId: putApiV4ProjectsIdPipelineSchedulesPipelineScheduleIdVariablesKey
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/putApiV4ProjectsIdPipelineSchedulesPipelineScheduleIdVariablesKey'
required: true
delete:
description: Delete a pipeline schedule variable
parameters:
- in: path
name: id
description: The ID or URL-encoded path of the project
required: true
example: 18
schema:
type: string
- in: path
name: pipeline_schedule_id
description: The pipeline schedule id
required: true
example: 13
schema:
type: integer
format: int32
- in: path
name: key
description: The key of the variable
required: true
example: NEW_VARIABLE
schema:
type: string
responses:
'202':
description: Delete a pipeline schedule variable
content:
application/json:
schema:
$ref: '#/components/schemas/API_Entities_Ci_Variable'
'401':
description: Unauthorized
'403':
description: Forbidden
'404':
description: Not found
tags:
- pipeline_schedules
operationId: deleteApiV4ProjectsIdPipelineSchedulesPipelineScheduleIdVariablesKey
components:
schemas:
API_Entities_Ci_Input:
type: object
properties:
name:
type: string
value:
type: string
required:
- name
- value
API_Entities_Ci_Variable:
type: object
properties:
variable_type:
type: string
example: env_var
key:
type: string
example: TEST_VARIABLE_1
value:
type: string
example: TEST_1
hidden:
type: boolean
protected:
type: boolean
masked:
type: boolean
raw:
type: boolean
environment_scope:
type: string
example: '*'
description:
type: string
example: This variable is being used for ...
required:
- variable_type
- key
- value
description: API_Entities_Ci_Variable model
postApiV4ProjectsIdPipelineSchedulesPipelineScheduleIdVariables:
type: object
properties:
key:
type: string
description: The key of the variable
example: NEW_VARIABLE
value:
type: string
description: The value of the variable
example: new value
variable_type:
type: string
description: The type of variable, must be one of env_var or file. Defaults to env_var
enum:
- env_var
- file
default: env_var
required:
- key
- value
description: Create a new pipeline schedule variable
putApiV4ProjectsIdPipelineSchedulesPipelineScheduleId:
type: object
properties:
description:
type: string
description: The description of pipeline schedule
example: Test schedule pipeline
ref:
type: string
description: The branch/tag name will be triggered
example: develop
cron:
type: string
description: The cron
example: '* * * * *'
cron_timezone:
type: string
description: The timezone
example: Asia/Tokyo
active:
type: boolean
description: The activation of pipeline schedule
example: true
inputs:
type: array
description: Inputs for the pipeline schedule
example:
- name: deploy_strategy
value: blue-green
items:
type: object
properties:
name:
type: string
description: The name of the input
example: deploy_strategy
destroy:
type: boolean
description: Whether to delete the input
default: false
value:
type: string
description: The value of the input
example: blue-green
required:
- name
- value
description: Edit a pipeline schedule
API_Entities_CustomAttribute:
type: object
properties:
key:
type: string
example: foo
value:
type: string
example: bar
required:
- key
- value
description: API_Entities_CustomAttribute model
API_Entities_Ci_PipelineSchedule:
type: object
properties:
id:
type: integer
format: int32
example: 13
description:
type: string
example: Test schedule pipeline
ref:
type: string
example: develop
cron:
type: string
example: '* * * * *'
cron_timezone:
type: string
example: Asia/Tokyo
next_run_at:
type: string
format: date-time
example: '2017-05-19T13:41:00.000Z'
active:
type: boolean
example: true
created_at:
type: string
format: date-time
example: '2017-05-19T13:31:08.849Z'
updated_at:
type: string
format: date-time
example: '2017-05-19T13:40:17.727Z'
owner:
$ref: '#/components/schemas/API_Entities_UserBasic'
inputs:
$ref: '#/components/schemas/API_Entities_Ci_Input'
required:
- id
- description
- ref
- cron
- cron_timezone
- next_run_at
- active
- created_at
- updated_at
- owner
description: API_Entities_Ci_PipelineSchedule model
API_Entities_UserBasic:
type: object
properties:
id:
type: integer
format: int32
example: 1
username:
type: string
example: admin
public_email:
type: string
example: john@example.com
name:
type: string
example: Administrator
state:
type: string
example: active
locked:
type: boolean
avatar_url:
type: string
example: https://gravatar.com/avatar/1
avatar_path:
type: string
example: /user/avatar/28/The-Big-Lebowski-400-400.png
custom_attributes:
type: array
items:
$ref: '#/components/schemas/API_Entities_CustomAttribute'
web_url:
type: string
example: https://gitlab.example.com/root
required:
- id
- username
- public_email
- name
- state
- locked
- avatar_url
- web_url
description: API_Entities_UserBasic model
postApiV4ProjectsIdPipelineSchedules:
type: object
properties:
description:
type: string
description: The description of pipeline schedule
example: Test schedule pipeline
ref:
type: string
description: The branch/tag name will be triggered
example: develop
cron:
type: string
description: The cron
example: '* * * * *'
cron_timezone:
type: string
description: The timezone
default: UTC
example: Asia/Tokyo
active:
type: boolean
description: The activation of pipeline schedule
default: true
example: true
inputs:
type: array
description: Inputs for the pipeline schedule
example:
- name: array_input
value:
- 1
- 2
- name: boolean_input
value: true
items:
type: object
properties:
name:
type: string
description: The name of the input
example: deploy_strategy
value:
type: string
description: The value of the input
example: blue-green
required:
- name
- value
required:
- description
- ref
- cron
description: Create a new pipeline schedule
API_Entities_Ci_PipelineBasic:
type: object
properties:
id:
type: integer
format: int32
example: 1
iid:
type: integer
format: int32
example: 2
project_id:
type: integer
format: int32
example: 3
sha:
type: string
example: 0ec9e58fdfca6cdd6652c083c9edb53abc0bad52
ref:
type: string
example: feature-branch
status:
type: string
example: success
source:
type: string
example: push
created_at:
type: string
format: date-time
example: '2022-10-21T16:49:48.000+02:00'
updated_at:
type: string
format: date-time
example: '2022-10-21T16:49:48.000+02:00'
web_url:
type: string
example: https://gitlab.example.com/gitlab-org/gitlab-foss/-/pipelines/61
required:
- id
- iid
- project_id
- sha
- ref
- status
- source
- created_at
- updated_at
- web_url
description: API_Entities_Ci_PipelineBasic model
putApiV4ProjectsIdPipelineSchedulesPipelineScheduleIdVariablesKey:
type: object
properties:
value:
type: string
description: The value of the variable
example: new value
variable_type:
type: string
description: The type of variable, must be one of env_var or file
enum:
- env_var
- file
default: env_var
description: Edit a pipeline schedule variable
API_Entities_Ci_PipelineScheduleDetails:
type: object
properties:
id:
type: integer
format: int32
example: 13
description:
type: string
example: Test schedule pipeline
ref:
type: string
example: develop
cron:
type: string
example: '* * * * *'
cron_timezone:
type: string
example: Asia/Tokyo
next_run_at:
type: string
format: date-time
example: '2017-05-19T13:41:00.000Z'
active:
type: boolean
example: true
created_at:
type: string
format: date-time
example: '2017-05-19T13:31:08.849Z'
updated_at:
type: string
format: date-time
example: '2017-05-19T13:40:17.727Z'
owner:
$ref: '#/components/schemas/API_Entities_UserBasic'
inputs:
$ref: '#/components/schemas/API_Entities_Ci_Input'
last_pipeline:
$ref: '#/components/schemas/API_Entities_Ci_PipelineBasic'
variables:
$ref: '#/components/schemas/API_Entities_Ci_Variable'
required:
- id
- description
- ref
- cron
- cron_timezone
- next_run_at
- active
- created_at
- updated_at
- owner
- last_pipeline
description: API_Entities_Ci_PipelineScheduleDetails model
securitySchemes:
access_token_header:
type: apiKey
name: PRIVATE-TOKEN
in: header
access_token_query:
type: apiKey
name: private_token
in: query