> ## 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.

# Get integration

> Retrieve a single integration by its ID.



## OpenAPI

````yaml /openapi/brms.json get /api/projects/{projectId}/integrations/{integrationId}
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}/integrations/{integrationId}:
    get:
      tags:
        - Integration
      summary: Get integration
      description: Retrieve a single integration by its ID.
      operationId: getIntegration
      parameters:
        - schema:
            type: string
            format: uuid
          in: path
          name: projectId
          required: true
          description: Project ID
        - schema:
            type: string
            format: uuid
          in: path
          name: integrationId
          required: true
          description: Integration ID
      responses:
        '200':
          description: Integration details
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                    description: Unique identifier of the integration
                  type:
                    type: string
                    enum:
                      - http
                    description: Type of integration
                  config:
                    type: object
                    properties:
                      method:
                        type: string
                        enum:
                          - post
                          - get
                          - delete
                          - put
                          - patch
                        description: HTTP method for the request
                      url:
                        type: string
                        description: URL endpoint for the HTTP request
                      timeout:
                        type: number
                        default: 5000
                        description: Request timeout in milliseconds
                      output:
                        type: string
                        nullable: true
                        description: Output mapping configuration
                      headers:
                        type: array
                        nullable: true
                        items:
                          type: object
                          properties:
                            key:
                              type: string
                              description: Header name
                            value:
                              type: string
                              description: Header value
                          required:
                            - key
                            - value
                          description: HTTP header key-value pair
                        default: []
                        description: HTTP headers to include in the request
                      cookies:
                        type: array
                        nullable: true
                        items:
                          type: object
                          properties:
                            key:
                              type: string
                              description: Cookie name
                            value:
                              type: string
                              description: Cookie value
                          required:
                            - key
                            - value
                          description: HTTP cookie key-value pair
                        default: []
                        description: Cookies to include in the request
                      enableInputs:
                        type: boolean
                        default: false
                        description: Enable custom input fields
                      inputs:
                        type: array
                        nullable: true
                        items:
                          type: object
                          properties:
                            control:
                              type: string
                              enum:
                                - text
                                - checkbox
                              description: Input control type
                            name:
                              type: string
                              description: Input field name
                            label:
                              type: string
                              description: Input field label
                          required:
                            - control
                            - name
                            - label
                          description: Custom input field configuration
                        default: []
                        description: Custom input field definitions
                    required:
                      - method
                      - url
                      - timeout
                      - headers
                      - cookies
                      - enableInputs
                      - inputs
                    description: Integration configuration
                  name:
                    type: string
                    description: Name of the integration
                  description:
                    type: string
                    nullable: true
                    description: Description of the integration
                  group:
                    type: string
                    nullable: true
                    description: Group the integration belongs to
                  kind:
                    type: string
                    description: Unique kind identifier for the integration
                  projectId:
                    type: string
                    format: uuid
                    description: Project ID the integration belongs to
                  createdAt:
                    type: string
                    description: Timestamp when the integration was created
                  updatedAt:
                    type: string
                    description: Timestamp when the integration was last updated
                  deletedAt:
                    type: string
                    nullable: true
                    description: Timestamp when the integration was deleted
                required:
                  - id
                  - type
                  - config
                  - name
                  - kind
                  - projectId
                  - createdAt
                  - updatedAt
                description: Integration details
      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

````