> ## Documentation Index > Fetch the complete documentation index at: https://docs.firedrill.run/llms.txt > Use this file to discover all available pages before exploring further. # Page through scheduled events, callbacks, or active faults > Cursors bind the exact session lease, filters, and collection revision. If work changes, restart from the first page after a lifecycle conflict. Faults have no status filter; event and callback statuses are category-specific. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/projects/{projectId}/sessions/{sessionId}/pending/items openapi: 3.1.0 info: title: Firedrill Control API version: 1.0.0 description: >- The control plane for drills, drill runs, and the worlds they run in. Errors always carry the canonical envelope; unsafe operations require an Idempotency-Key; long work returns an operation resource. servers: - url: https://api.firedrill.run security: - controlCredential: [] tags: - name: authentication description: Sessions, CLI exchange, credentials, and verification keys. x-group: Authentication - name: organizations description: Organization members, billing, usage, retention, audit, and exports. x-group: Organizations - name: projects description: Project lifecycle, access, grants, and repository bindings. x-group: Projects - name: builds description: Immutable builds, uploads, source drafts, and world definitions. x-group: Builds and source - name: tools description: Project Tool discovery, approval, source, and revocation. x-group: Tool library - name: worlds description: >- Managed environments, world sessions, state, time, reset, faults, forks, and snapshots. x-group: Environments and sessions - name: runs description: >- Hosted runs, comparisons, attachments, reports, evidence bundles, sharing, and exports. x-group: Runs and evidence - name: browser description: Managed browser tests, runs, messages, streams, frames, and artifacts. x-group: Browser testing - name: callbacks description: Callback receiver approval, revocation, and signing material. x-group: Callbacks - name: github-ci description: >- GitHub installations, repository automation, CI suites, cases, evidence, and checks. x-group: GitHub and CI - name: authoring description: Authoring sessions, proposals, turns, and scenario proposals. x-group: Cloud authoring paths: /v1/projects/{projectId}/sessions/{sessionId}/pending/items: get: tags: - worlds summary: Page through scheduled events, callbacks, or active faults description: >- Cursors bind the exact session lease, filters, and collection revision. If work changes, restart from the first page after a lifecycle conflict. Faults have no status filter; event and callback statuses are category-specific. operationId: sessions.listPendingItems parameters: - name: projectId in: path required: true schema: type: string pattern: ^prj_[0-9a-z]{12,32}$ - name: sessionId in: path required: true schema: type: string pattern: ^ses_[0-9a-z]{12,32}$ - name: category in: query required: true schema: type: string enum: - events - callbacks - faults - name: packageId in: query required: false schema: type: string minLength: 1 maxLength: 96 - name: status in: query required: false schema: type: string enum: - pending - fired - failed - cancelled - in_flight - delivered - name: cursor in: query required: false schema: type: string minLength: 1 maxLength: 2048 - name: limit in: query required: false schema: default: 50 type: integer minimum: 1 maximum: 100 responses: '200': description: Pending-work page content: application/json: schema: $ref: '#/components/schemas/WorldPendingPage' default: description: Canonical error envelope content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' components: schemas: WorldPendingPage: oneOf: - type: object properties: schemaVersion: type: number enum: - 1 sessionId: type: string pattern: ^ses_[0-9a-z]{12,32}$ leaseGeneration: type: integer minimum: 0 exclusiveMinimum: true maximum: 9007199254740991 revision: type: string pattern: ^sha256:[0-9a-f]{64}$ description: >- Fingerprint of the selected pending-work collection. A change invalidates its cursor. total: type: integer minimum: -9007199254740991 maximum: 9007199254740991 nextCursor: type: string minLength: 1 maxLength: 2048 category: type: string enum: - events items: maxItems: 100 type: array items: type: object properties: id: type: string pattern: ^pending_[A-Za-z0-9][A-Za-z0-9_-]{5,95}$ event: type: object properties: packageId: type: string minLength: 1 maxLength: 96 pattern: ^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$ eventId: type: string minLength: 1 maxLength: 160 pattern: >- ^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*(?:\.[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*)*$ required: - packageId - eventId additionalProperties: false payload: type: object additionalProperties: $ref: '#/components/schemas/WorldPendingPage___schema0' dueUs: type: integer minimum: -9007199254740991 maximum: 9007199254740991 correlationId: type: string pattern: ^corr_[A-Za-z0-9][A-Za-z0-9_-]{5,95}$ actorBindingId: type: string pattern: ^actor_[A-Za-z0-9][A-Za-z0-9_-]{5,95}$ causeSequence: type: integer minimum: 0 exclusiveMinimum: true maximum: 9007199254740991 status: type: string enum: - pending - fired - failed - cancelled required: - id - event - payload - dueUs - correlationId - actorBindingId - causeSequence - status additionalProperties: false required: - schemaVersion - sessionId - leaseGeneration - revision - total - category - items additionalProperties: false - type: object properties: schemaVersion: type: number enum: - 1 sessionId: type: string pattern: ^ses_[0-9a-z]{12,32}$ leaseGeneration: type: integer minimum: 0 exclusiveMinimum: true maximum: 9007199254740991 revision: type: string pattern: ^sha256:[0-9a-f]{64}$ description: >- Fingerprint of the selected pending-work collection. A change invalidates its cursor. total: type: integer minimum: -9007199254740991 maximum: 9007199254740991 nextCursor: type: string minLength: 1 maxLength: 2048 category: type: string enum: - callbacks items: maxItems: 100 type: array items: type: object properties: id: type: string pattern: ^delivery_[A-Za-z0-9][A-Za-z0-9_-]{5,95}$ callback: type: object properties: packageId: type: string minLength: 1 maxLength: 96 pattern: ^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$ callbackId: type: string minLength: 1 maxLength: 96 pattern: ^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$ required: - packageId - callbackId additionalProperties: false receiverId: type: string minLength: 1 maxLength: 96 pattern: ^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$ event: type: object properties: packageId: type: string minLength: 1 maxLength: 96 pattern: ^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$ eventId: type: string minLength: 1 maxLength: 160 pattern: >- ^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*(?:\.[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*)*$ required: - packageId - eventId additionalProperties: false payload: type: object additionalProperties: $ref: '#/components/schemas/WorldPendingPage___schema0' eventSequence: type: integer minimum: 0 exclusiveMinimum: true maximum: 9007199254740991 dueUs: type: integer minimum: -9007199254740991 maximum: 9007199254740991 correlationId: type: string pattern: ^corr_[A-Za-z0-9][A-Za-z0-9_-]{5,95}$ actorBindingId: type: string pattern: ^actor_[A-Za-z0-9][A-Za-z0-9_-]{5,95}$ status: type: string enum: - pending - in_flight - delivered - failed attemptCount: type: integer minimum: -9007199254740991 maximum: 9007199254740991 retryDelaysUs: maxItems: 100 type: array items: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - id - callback - receiverId - event - payload - eventSequence - dueUs - correlationId - actorBindingId - status - attemptCount - retryDelaysUs additionalProperties: false required: - schemaVersion - sessionId - leaseGeneration - revision - total - category - items additionalProperties: false - type: object properties: schemaVersion: type: number enum: - 1 sessionId: type: string pattern: ^ses_[0-9a-z]{12,32}$ leaseGeneration: type: integer minimum: 0 exclusiveMinimum: true maximum: 9007199254740991 revision: type: string pattern: ^sha256:[0-9a-f]{64}$ description: >- Fingerprint of the selected pending-work collection. A change invalidates its cursor. total: type: integer minimum: -9007199254740991 maximum: 9007199254740991 nextCursor: type: string minLength: 1 maxLength: 2048 category: type: string enum: - faults items: maxItems: 100 type: array items: type: object properties: packageId: type: string minLength: 1 maxLength: 96 pattern: ^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$ faultId: type: string minLength: 1 maxLength: 96 pattern: ^[a-z][a-z0-9]*(?:[-_][a-z0-9]+)*$ required: - packageId - faultId additionalProperties: false required: - schemaVersion - sessionId - leaseGeneration - revision - total - category - items additionalProperties: false ErrorEnvelope: type: object properties: code: type: string pattern: ^(control|world)\.[A-Z][A-Z0-9]*(_[A-Z0-9]+)*$ message: type: string minLength: 1 correlationId: type: string minLength: 1 retryable: type: boolean retryAfterMs: type: integer exclusiveMinimum: 0 maximum: 9007199254740991 operationId: type: string source: type: string enum: - platform - simulated_provider issues: type: array items: type: object properties: path: type: string code: type: string message: type: string required: - path - code - message additionalProperties: false details: type: object propertyNames: type: string additionalProperties: {} evidence: type: object properties: sessionId: type: string runId: type: string journalSeq: type: integer minimum: 0 maximum: 9007199254740991 buildHash: type: string additionalProperties: false required: - code - message - correlationId - retryable - source additionalProperties: true WorldPendingPage___schema0: description: Any JSON-compatible value securitySchemes: controlCredential: type: http scheme: bearer description: Opaque control credential ````