> ## Documentation Index > Fetch the complete documentation index at: https://docs.agentsfleet.net/llms.txt > Use this file to discover all available pages before exploring further. # List the running fleet's schedules > Lists every schedule of the fleet the lease runs, oldest first. Each names its `source`: `api` for a person, `trigger` for the fleet's own document, `fleet` for the fleet itself. Only a `fleet` schedule can be changed through the lease. ## OpenAPI ````yaml https://raw.githubusercontent.com/agentsfleet/agentsfleet/main/public/openapi.json get /v1/runners/me/leases/{lease_id}/schedules openapi: 3.1.0 info: title: agentsfleet Control Plane API description: API for managing workspaces, fleets, triggers, and runs. contact: name: agentsfleet url: https://agentsfleet.net license: name: MIT identifier: MIT version: 1.0.0 servers: - url: https://api.agentsfleet.net description: Production security: [] paths: /v1/runners/me/leases/{lease_id}/schedules: get: tags: - Schedules summary: List the running fleet's schedules description: >- Lists every schedule of the fleet the lease runs, oldest first. Each names its `source`: `api` for a person, `trigger` for the fleet's own document, `fleet` for the fleet itself. Only a `fleet` schedule can be changed through the lease. operationId: runner_list_schedules parameters: - name: lease_id in: path description: '`UUIDv7` of the lease.' required: true schema: type: string - name: fencing_token in: query description: >- The lease's fencing token. A holder the fleet has moved past is refused. required: true schema: type: integer format: int64 minimum: 0 responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/Page' '400': description: The request could not be read content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '401': description: No credential, or one this route does not accept content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '403': description: The credential is good and lacks the capability this route requires content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '404': description: No such resource, or none this caller may see content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '409': description: The request conflicts with the resource's current state content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '429': description: The instance is at its ceiling content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '500': description: The daemon failed to answer content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' '503': description: A dependency this route needs is unreachable content: application/problem+json: schema: $ref: '#/components/schemas/ProblemBody' security: - RunnerBearerAuth: [] components: schemas: Page: type: object description: A page of schedules. required: - schedules properties: schedules: type: array items: $ref: '#/components/schemas/View' description: The fleet's schedules, oldest first. ProblemBody: type: object description: The body every refusal carries, under `application/problem+json`. required: - docs_uri - title - detail - error_code - request_id properties: action_id: type: - string - 'null' description: 'On that 409 only: the action the gate held.' current_state: type: - string - 'null' description: 'On a 409 only: the state that forbade the transition.' detail: type: string description: One sentence on what was refused and why. docs_uri: type: string description: Where the error code is documented. error_code: type: string description: The registry code, stable across releases. etag: type: - string - 'null' description: >- On a 412 only: the resource's current entity tag, to refetch and retry. gate_id: type: - string - 'null' description: 'On an answered approval gate''s 409 only: the gate that was answered.' outcome: type: - string - 'null' description: 'On that 409 only: the answer that stands.' request_id: type: string description: The request this refusal answers, for support. resolved_at: type: - integer - 'null' format: int64 description: 'On that 409 only: when the standing answer was given.' resolved_by: type: - string - 'null' description: 'On that 409 only: who gave it.' title: type: string description: A short name for the refusal, safe to show a person. user_message: type: - string - 'null' description: A curated sentence for end users, where the code has one. View: type: object description: One schedule, as the tenant surface renders it. required: - schedule_id - fleet_id - cron - timezone - message - source - once - status - sync - etag - created_at - updated_at properties: created_at: type: integer format: int64 description: When it was created. cron: type: string description: The expression it fires on. etag: type: string description: Strong tag binding the pinned recipe, setup and instance override. fleet_id: type: string description: The fleet it wakes. last_error: type: - string - 'null' description: Why the last push failed, when one did. message: type: string description: What the fleet is asked to do. once: type: boolean description: >- Whether it retires after its first fire. Beta: this field may change shape before it is stable. x-stability: beta override: oneOf: - type: 'null' - $ref: '#/components/schemas/Override' description: >- Explicit instance overlay, omitted when the pinned recipe is inherited. schedule_id: type: string description: Its identity. source: type: string description: >- Who made it: `api` for a person, `trigger` for the fleet's own document, `fleet` for the fleet while it ran. Only a `fleet` schedule can be changed by the fleet. Beta: this field may change shape before it is stable. x-stability: beta status: type: string description: What the operator wants it to be doing. sync: type: string description: |- How far agentsfleet has brought the external scheduler in line. A schedule can save without registering. This field shows you that state. timezone: type: string description: The zone that expression is read in. updated_at: type: integer format: int64 description: When it was last changed. Override: type: object description: Instance fields overlaid on a fleet's pinned recipe. properties: cron: type: - string - 'null' description: Replacement five-field expression. default: null message: type: - string - 'null' description: Replacement scheduled message. default: null status: oneOf: - type: 'null' - $ref: '#/components/schemas/Status' description: Replacement firing intent. default: null timezone: type: - string - 'null' description: Replacement timezone name. default: null additionalProperties: false Status: type: string description: >- Human-editable schedule intent; deletion keeps its separate resource verb. enum: - active - paused securitySchemes: RunnerBearerAuth: type: http scheme: bearer bearerFormat: agt_r description: The opaque agt_r token minted when the runner enrols (POST /v1/runners) ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.