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

# Update Integration

> Update an integration by ID. Supports name, config, connectionId, environment, and enabled.



## OpenAPI

````yaml https://hub.griff.services/documentation/json patch /integrations/{id}
openapi: 3.1.0
info:
  title: Griffin Hub API
  description: API for managing and running test monitors
  version: 1.0.0
servers:
  - url: https://hub.griff.services
    description: Local development server
  - url: http://localhost:3000
    description: Local development server
security:
  - bearerAuth: []
tags:
  - name: monitors
    description: Test monitor management endpoints
  - name: runs
    description: Test run management endpoints
  - name: metrics
    description: Metrics and health summary endpoints
paths:
  /integrations/{id}:
    patch:
      tags:
        - integrations
      summary: Update Integration
      description: >-
        Update an integration by ID. Supports name, config, connectionId,
        environment, and enabled.
      parameters:
        - schema:
            type: string
          in: path
          name: id
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                config:
                  anyOf:
                    - type: object
                      required:
                        - providerType
                        - fromAddress
                      properties:
                        providerType:
                          type: string
                          enum:
                            - email
                        fromAddress:
                          type: string
                        fromName:
                          type: string
                        replyTo:
                          type: string
                    - type: object
                      required:
                        - providerType
                        - url
                      properties:
                        providerType:
                          type: string
                          enum:
                            - webhook
                        url:
                          type: string
                        headers:
                          type: object
                          additionalProperties:
                            type: string
                    - type: object
                      required:
                        - providerType
                      properties:
                        providerType:
                          type: string
                          enum:
                            - slack
                        channel:
                          type: string
                        mentionUsers:
                          type: array
                          items:
                            type: string
                    - type: object
                      required:
                        - providerType
                        - region
                      properties:
                        providerType:
                          type: string
                          enum:
                            - aws
                        region:
                          type: string
                connectionId:
                  anyOf:
                    - type: string
                    - type: 'null'
                environment:
                  anyOf:
                    - type: string
                    - type: 'null'
                enabled:
                  type: boolean
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    $ref: '#/components/schemas/Integration'
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
        '502':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
        '503':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
        '504':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                properties:
                  error:
                    type: string
components:
  schemas:
    Integration:
      type: object
      required:
        - id
        - organizationId
        - category
        - provider
        - name
        - hasCredentials
        - enabled
        - createdAt
        - updatedAt
      properties:
        id:
          type: string
        organizationId:
          type: string
        category:
          type: string
          enum:
            - notifications
            - secrets
            - metrics
          title: IntegrationCategory
        provider:
          type: string
          enum:
            - aws
            - vault
            - slack
            - email
            - webhook
            - resend
          title: Provider
        name:
          type: string
        connectionId:
          type: string
        config:
          $ref: '#/components/schemas/IntegrationConfig'
        hasCredentials:
          type: boolean
        enabled:
          type: boolean
        environment:
          type: string
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
      title: Integration
    IntegrationConfig:
      anyOf:
        - type: object
          required:
            - providerType
            - fromAddress
          properties:
            providerType:
              type: string
              enum:
                - email
            fromAddress:
              type: string
            fromName:
              type: string
            replyTo:
              type: string
        - type: object
          required:
            - providerType
            - url
          properties:
            providerType:
              type: string
              enum:
                - webhook
            url:
              type: string
            headers:
              type: object
              additionalProperties:
                type: string
        - type: object
          required:
            - providerType
          properties:
            providerType:
              type: string
              enum:
                - slack
            channel:
              type: string
            mentionUsers:
              type: array
              items:
                type: string
        - type: object
          required:
            - providerType
            - region
          properties:
            providerType:
              type: string
              enum:
                - aws
            region:
              type: string
      title: IntegrationConfig
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````