> ## Documentation Index > Fetch the complete documentation index at: https://nango.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # Update an integration > Edit an integration > [!NOTE] > > Requires an API key with the `environment:integrations:update` scope. [Learn more about API key scopes](https://nango.dev/docs/reference/backend/http-api/api-keys.md#scopes). ## OpenAPI ````yaml PATCH /integrations/{uniqueKey} openapi: 3.1.0 info: title: Nango API description: Nango API specs used to authorize & sync data with external APIs. version: 1.0.0 servers: - url: https://api.nango.dev description: Production server - url: http://localhost:3003 description: Local server security: - bearerAuth: [] externalDocs: url: https://nango.dev/docs/reference/backend/http-api/authentication paths: /integrations/{uniqueKey}: patch: summary: Edit an integration description: Edit an integration parameters: - name: uniqueKey in: path required: true schema: type: string description: The integration ID (unique_key) that you created in Nango. requestBody: required: true content: application/json: schema: type: object properties: unique_key: type: string description: >- A unique integration ID, which you will use in the other API calls to reference this integration. display_name: type: string description: The integration display name. forward_webhooks: type: boolean description: Whether to forward webhooks received for this integration. credentials: $ref: '#/components/schemas/IntegrationCredentialsInput' description: > Developer app credentials for the integration. Only the fields you pass are updated; the ones you leave out keep their current value. integration_config: type: object additionalProperties: type: string description: > Provider-specific configuration for providers that declare an `integration_config` schema (e.g. `private-api-generic`, `aws-sigv4`). Only the fields you pass are updated. custom: type: object additionalProperties: type: string description: > Free-form key-value settings stored on the integration, for providers without an `integration_config` schema. Merged with existing values. Rejected for providers that declare one; use `integration_config` instead. responses: '200': description: Successfully updated an integration content: application/json: schema: type: object required: - data properties: data: $ref: '#/components/schemas/Integration' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' components: schemas: IntegrationCredentialsInput: description: > Integration credentials schema accepted in create/update request bodies. Only `type` is required: developer app credentials can be omitted at creation and supplied later, either with an update request or per connection at connection time. Fields left out of an update are kept as-is rather than cleared. MCP_OAUTH2 is the exception — static creation requires both client_id and client_secret, while dynamic and CIMD providers reject those fields because Nango manages them. Optional fields must not be null. oneOf: - type: object additionalProperties: false required: - type properties: type: type: string enum: - OAUTH1 - OAUTH2 - TBA client_id: type: string minLength: 1 maxLength: 255 client_secret: type: string minLength: 1 scopes: type: string pattern: ^(?:[0-9a-zA-Z:/_.*-]+(,[0-9a-zA-Z:/_.*-]+)*)?$ webhook_secret: type: string maxLength: 255 - type: object additionalProperties: false required: - type properties: type: type: string enum: - APP app_id: type: string minLength: 1 maxLength: 255 app_link: type: string minLength: 1 private_key: type: string pattern: >- ^-----BEGIN RSA PRIVATE KEY----[\s\S]*-----END RSA PRIVATE KEY-----$ - type: object additionalProperties: false required: - type properties: type: type: string enum: - CUSTOM client_id: type: string minLength: 1 maxLength: 255 client_secret: type: string minLength: 1 app_id: type: string minLength: 1 maxLength: 255 app_link: type: string minLength: 1 private_key: type: string pattern: >- ^-----BEGIN RSA PRIVATE KEY----[\s\S]*-----END RSA PRIVATE KEY-----$ - type: object additionalProperties: false required: - type properties: type: type: string enum: - MCP_OAUTH2_GENERIC client_name: type: string minLength: 1 maxLength: 255 client_uri: type: string description: A URL, or an empty string. maxLength: 255 client_logo_uri: type: string format: uri maxLength: 255 - type: object additionalProperties: false required: - type properties: type: type: string enum: - MCP_OAUTH2 client_id: type: string minLength: 1 maxLength: 255 client_secret: type: string minLength: 1 scopes: type: string pattern: ^(?:[0-9a-zA-Z:/_.*-]+([, ]+[0-9a-zA-Z:/_.*-]+)*)?$ Integration: type: object additionalProperties: false required: - unique_key - display_name - provider - created_at - updated_at properties: unique_key: type: string description: The integration ID that you created in Nango. display_name: type: string description: The provider display name. provider: type: string description: The Nango API Configuration. logo: type: string description: Absolute path to the logo of this integration (svg) created_at: type: string format: date-time description: When it was created updated_at: type: string format: date-time description: Last time it was updated forward_webhooks: type: boolean description: >- Whether webhooks received from this integration's provider are forwarded to your backend. missing_fields: type: array items: type: string description: > Credential fields the integration is missing, e.g. `oauth_client_id`. Empty when the integration is fully configured, when it uses Nango-provided credentials, or when the auth mode collects everything at connection time. Field names only, never values. StdError: type: object additionalProperties: false properties: error: type: object additionalProperties: false required: - code properties: code: type: string message: type: string errors: type: array items: type: object responses: BadRequest: description: Bad request content: application/json: schema: $ref: '#/components/schemas/StdError' Unauthorized: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/StdError' NotFound: description: Not Found content: application/json: schema: $ref: '#/components/schemas/StdError' securitySchemes: bearerAuth: type: http scheme: bearer description: >- An Environment API key from your Nango environment, or an Account API key for account-level endpoints. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.