> ## Documentation Index > Fetch the complete documentation index at: https://docs.cachethq.io/llms.txt > Use this file to discover all available pages before exploring further. # List Schedule Updates ## OpenAPI ````yaml /api-reference/openapi.json get /schedules/{schedule}/updates openapi: 3.1.0 info: title: Cachet version: 0.0.1 description: >- API documentation for Cachet, the open source, self-hosted status page system. servers: - url: http://localhost:8001/api - url: https://v3.cachethq.io/api description: The Cachet v3 demo server. security: - http: [] tags: - name: Cachet - name: Components - name: Component Groups - name: Incidents - name: Incident Updates - name: Incident Templates - name: Metrics - name: Metric Points - name: Schedules - name: Schedule Updates - name: Subscribers paths: /schedules/{schedule}/updates: get: tags: - Schedule Updates summary: List Schedule Updates operationId: cachet.api.schedules.updates.index parameters: - name: schedule in: path required: true description: The schedule ID schema: type: integer - name: per_page in: query description: How many items to show per page. schema: type: integer default: 15 example: 20 - name: page in: query description: Which page to show. schema: type: integer example: 2 - name: sort in: query schema: type: array items: type: string enum: - created_at - '-created_at' explode: false - name: include in: query schema: type: array items: type: string enum: - schedule - scheduleCount - scheduleExists explode: false responses: '200': description: Paginated set of `Update` content: application/vnd.api+json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/Update' links: type: object properties: first: type: string last: type: string prev: type: string next: type: string meta: type: object properties: current_page: type: integer minimum: 1 from: type: - integer - 'null' minimum: 1 path: type: - string - 'null' description: Base path for paginator generated URLs. per_page: type: integer description: Number of items shown per page. minimum: 0 to: type: - integer - 'null' description: Number of the last item in the slice. minimum: 1 required: - current_page - from - path - per_page - to included: type: array items: anyOf: - $ref: '#/components/schemas/Incident' - $ref: '#/components/schemas/Schedule' required: - data - links - meta '404': $ref: '#/components/responses/ModelNotFoundException' security: [] components: schemas: Update: type: object properties: id: type: string type: type: string enum: - updates attributes: type: object properties: id: type: integer updateable_id: type: integer updateable_type: type: string message: type: string status: type: object properties: human: type: - string - 'null' enum: - Investigating - Identified - Watching - Fixed - Reported - null value: type: - integer - 'null' required: - human - value created: type: object properties: human: type: - string - 'null' string: type: - string - 'null' required: - human - string updated: type: object properties: human: type: - string - 'null' string: type: - string - 'null' required: - human - string required: - id - updateable_id - updateable_type - message - created - updated relationships: type: object properties: incident: type: object properties: data: anyOf: - $ref: '#/components/schemas/IncidentIdentifier' - type: 'null' required: - data schedule: type: object properties: data: anyOf: - $ref: '#/components/schemas/ScheduleIdentifier' - type: 'null' required: - data required: - id - type title: Update Incident: type: object properties: id: type: string type: type: string enum: - incidents attributes: type: object properties: id: type: integer guid: type: string name: type: string message: type: string visible: $ref: '#/components/schemas/ResourceVisibilityEnum' stickied: type: boolean notifications: type: integer meta: type: array items: {} components_count: type: string status: type: object properties: human: type: - string - 'null' value: type: - string - 'null' required: - human - value occurred: type: object properties: human: type: - string - 'null' string: type: - string - 'null' required: - human - string created: type: object properties: human: type: - string - 'null' string: type: - string - 'null' required: - human - string updated: type: object properties: human: type: - string - 'null' string: type: - string - 'null' required: - human - string required: - id - guid - name - message - visible - stickied - notifications - status - occurred - created - updated relationships: type: object properties: components: type: object properties: data: type: array items: $ref: '#/components/schemas/ComponentIdentifier' required: - data updates: type: object properties: data: type: array items: $ref: '#/components/schemas/UpdateIdentifier' required: - data user: type: object properties: data: anyOf: - $ref: '#/components/schemas/UserIdentifier' - type: 'null' required: - data required: - id - type title: Incident Schedule: type: object properties: id: type: string type: type: string enum: - schedules attributes: type: object properties: id: type: integer name: type: string message: type: - string - 'null' meta: type: array items: {} status: type: object properties: human: type: string value: type: string required: - human - value scheduled: type: object properties: human: type: string string: type: string required: - human - string completed: type: object properties: human: type: - string - 'null' string: type: - string - 'null' required: - human - string created: type: object properties: human: type: - string - 'null' string: type: - string - 'null' required: - human - string updated: type: object properties: human: type: - string - 'null' string: type: - string - 'null' required: - human - string required: - id - name - message - status - scheduled - completed - created - updated relationships: type: object properties: components: type: object properties: data: type: array items: $ref: '#/components/schemas/ComponentIdentifier' required: - data updates: type: object properties: data: type: array items: $ref: '#/components/schemas/UpdateIdentifier' required: - data required: - id - type title: Schedule IncidentIdentifier: type: object properties: type: type: string enum: - incidents id: type: string required: - type - id title: IncidentIdentifier ScheduleIdentifier: type: object properties: type: type: string enum: - schedules id: type: string required: - type - id title: ScheduleIdentifier ResourceVisibilityEnum: type: integer enum: - 0 - 1 - 2 title: ResourceVisibilityEnum ComponentIdentifier: type: object properties: type: type: string enum: - components id: type: string required: - type - id title: ComponentIdentifier UpdateIdentifier: type: object properties: type: type: string enum: - updates id: type: string required: - type - id title: UpdateIdentifier UserIdentifier: type: object properties: type: type: string id: type: string required: - type - id title: UserIdentifier responses: ModelNotFoundException: description: Not found content: application/json: schema: type: object properties: message: type: string description: Error overview. required: - message securitySchemes: http: type: http scheme: bearer ````