> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gorules.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List change requests

> Retrieve a paginated list of change requests for a project. Supports filtering by document, release, type, and status.



## OpenAPI

````yaml /openapi/brms.json get /api/projects/{projectId}/change-requests
openapi: 3.0.3
info:
  title: GoRules BRMS
  version: local
servers: []
security: []
tags:
  - name: AI
    description: >-
      AI-powered assistant for interactive conversations and decision logic
      generation
  - name: Audit log
    description: Track and export organisation activity logs for compliance and monitoring
  - name: Branches
    description: >-
      Manage feature branches for collaborative decision development with
      commits and merging
  - name: Change requests
    description: Review and approve changes before merging or deploying to environments
  - name: Cloud
    description: Cloud-specific endpoints for organisation and client management
  - name: Decision
    description: Evaluate and simulate decision graphs with trace and performance data
  - name: Deployment workflows
    description: Manage deployment workflow runs and job approvals
  - name: Deployments
    description: Configure cloud storage providers for release deployments
  - name: Document
    description: Manage decision documents, versions, and file operations within projects
  - name: Environment
    description: >-
      Configure deployment environments with approval workflows and access
      tokens
  - name: Group
    description: Manage permission groups for project-level access control
  - name: Infrastructure
    description: Health check and infrastructure status endpoints
  - name: Integration
    description: Configure external integrations for HTTP requests and data sources
  - name: Invitation
    description: Manage organisation invitations for new members
  - name: Member
    description: Manage project membership and group assignments
  - name: Organisation
    description: Manage organisation settings, preferences, and licensing
  - name: Personal access token
    description: Create and manage personal access tokens for API authentication
  - name: Profile
    description: Manage current user profile settings
  - name: Project
    description: Create and manage projects with approval workflows
  - name: Release
    description: >-
      Package, version, and deploy decision documents. Learn more about
      [Releases](https://gorules.io/developers/brms/multi-environment)
  - name: Roles
    description: Define custom roles with permissions for organisation-wide access control
  - name: Security
    description: Manage project access tokens for API authentication
  - name: Templates
    description: Browse and apply project templates for quick onboarding
  - name: Test events
    description: Manage test events for decision evaluation and testing
  - name: User
    description: Manage organisation users, invitations, and service accounts
paths:
  /api/projects/{projectId}/change-requests:
    get:
      tags:
        - Change requests
      summary: List change requests
      description: >-
        Retrieve a paginated list of change requests for a project. Supports
        filtering by document, release, type, and status.
      operationId: listChangeRequests
      parameters:
        - schema:
            type: number
            default: 1
          in: query
          name: page
          description: Current page
        - schema:
            type: number
            default: 10
          in: query
          name: perPage
          description: Number of items per page
        - schema:
            type: string
            nullable: true
            format: uuid
          in: query
          name: documentId
          description: Filter by document ID
        - schema:
            type: string
            nullable: true
            format: uuid
          in: query
          name: releaseId
          description: Filter by release ID
        - schema:
            nullable: true
            anyOf:
              - type: array
                items:
                  type: string
                  enum:
                    - decisions
                    - deployments
                    - publish_document
                    - unpublish_document
                    - deploy_environment
                    - undeploy_environment
              - type: string
                enum:
                  - decisions
                  - deployments
                  - publish_document
                  - unpublish_document
                  - deploy_environment
                  - undeploy_environment
          in: query
          name: type
          description: Filter by change request type(s)
        - schema:
            type: string
            nullable: true
            enum:
              - pending
              - closed
              - null
          in: query
          name: status
          description: Filter by status (pending or closed)
        - schema:
            type: string
            format: uuid
          in: path
          name: projectId
          required: true
          description: Project unique identifier
      responses:
        '200':
          description: Paginated list of change requests
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: Change request unique identifier
                        type:
                          type: string
                          enum:
                            - publish_document
                            - unpublish_document
                            - deploy_environment
                            - undeploy_environment
                            - merge_branch
                          description: Type of change request
                        status:
                          type: string
                          enum:
                            - pending
                            - rejected
                            - cancelled
                            - completed
                          description: Current status of the change request
                        description:
                          type: string
                          nullable: true
                          description: Change request description
                        projectId:
                          type: string
                          format: uuid
                          description: Project unique identifier
                        document:
                          type: object
                          nullable: true
                          properties:
                            id:
                              type: string
                              format: uuid
                              description: Document unique identifier
                            name:
                              type: string
                              description: Document name
                            key:
                              type: string
                              nullable: true
                              description: Document key
                          required:
                            - id
                            - name
                          description: Document information
                        documentId:
                          type: string
                          nullable: true
                          format: uuid
                          description: Document unique identifier
                        environment:
                          type: object
                          nullable: true
                          properties:
                            id:
                              type: string
                              format: uuid
                              description: Environment unique identifier
                            name:
                              type: string
                              description: Environment name
                          required:
                            - id
                            - name
                          description: Environment information
                        environmentId:
                          type: string
                          nullable: true
                          format: uuid
                          description: Environment unique identifier
                        release:
                          type: object
                          nullable: true
                          properties:
                            id:
                              type: string
                              format: uuid
                              description: Release unique identifier
                            name:
                              type: string
                              description: Release name
                            version:
                              type: string
                              nullable: true
                              description: Release version
                          required:
                            - id
                            - name
                          description: Release information
                        releaseId:
                          type: string
                          nullable: true
                          format: uuid
                          description: Release unique identifier
                        branch:
                          type: object
                          nullable: true
                          properties:
                            id:
                              type: string
                              format: uuid
                              description: Branch unique identifier
                            name:
                              type: string
                              description: Branch name
                          required:
                            - id
                            - name
                          description: Branch information
                        branchId:
                          type: string
                          nullable: true
                          format: uuid
                          description: Branch unique identifier
                        commit:
                          type: object
                          nullable: true
                          properties:
                            id:
                              type: string
                              format: uuid
                              description: Commit unique identifier
                            message:
                              type: string
                              nullable: true
                              description: Commit message
                          required:
                            - id
                          description: Commit information
                        createdAt:
                          type: string
                          description: Change request creation timestamp
                        createdBy:
                          type: object
                          nullable: true
                          properties:
                            id:
                              type: string
                              format: uuid
                              description: User unique identifier
                            email:
                              type: string
                              format: email
                              description: User email address
                            firstName:
                              type: string
                              nullable: true
                              description: User first name
                            lastName:
                              type: string
                              nullable: true
                              description: User last name
                          required:
                            - id
                            - email
                            - firstName
                            - lastName
                          description: User information
                        updatedAt:
                          type: string
                          description: Change request last update timestamp
                      required:
                        - id
                        - type
                        - status
                        - projectId
                        - createdAt
                        - updatedAt
                      description: Change request
                    description: List of change requests
                  paginate:
                    type: object
                    properties:
                      current:
                        type: number
                        description: Current page number
                      from:
                        type: number
                        description: Starting record number
                      to:
                        type: number
                        description: Ending record number
                      total:
                        type: number
                        description: Total number of records
                      pageSize:
                        type: number
                        description: Number of records per page
                    required:
                      - current
                      - from
                      - to
                      - total
                      - pageSize
                    description: Pagination metadata
                required:
                  - results
                  - paginate
                description: Paginated list of change requests
      security:
        - personalAccessToken: []
        - internalAuth: []
components:
  securitySchemes:
    personalAccessToken:
      type: http
      scheme: bearer
      description: Personal access token is obtained through your profile
    internalAuth:
      type: http
      scheme: internal
      description: Cannot be used directly

````