IntegrationPatchRequestData

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/snyk/main/json-schema/snyk-integration-patch-request-data-schema.json",
  "title": "IntegrationPatchRequestData",
  "description": "Request body for updating an integration (partial update supported)",
  "x-generated": "2026-10-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/snyk-integrations-api-openapi.yml#/components/schemas/IntegrationPatchRequestData",
  "additionalProperties": false,
  "properties": {
    "data": {
      "additionalProperties": false,
      "description": "The integration data",
      "properties": {
        "attributes": {
          "additionalProperties": false,
          "description": "Integration attributes to update. Only include fields you want to modify.\nNote: integration_type cannot be changed after creation.\n",
          "properties": {
            "credentials": {
              "description": "Integration credentials (structure varies by integration_type).\nOnly include fields you want to update.\n\nCredential types:\n- ECR: role_arn + region\n- Docker Hub: username + password\n- Generic (ACR, Artifactory, Harbor, etc.): username + password + registry_base\n- DigitalOcean: token\n- GCR/GAR: password (JSON key) + registry_base\n",
              "oneOf": [
                {
                  "$ref": "#/$defs/EcrCredentials"
                },
                {
                  "$ref": "#/$defs/DockerHubCredentials"
                },
                {
                  "$ref": "#/$defs/GenericContainerRegistryCredentials"
                },
                {
                  "$ref": "#/$defs/DigitalOceanCredentials"
                },
                {
                  "$ref": "#/$defs/GcrCredentials"
                }
              ]
            },
            "profile_name": {
              "description": "User-defined name to identify this integration. Allows alphanumeric characters, spaces, hyphens, underscores, and dots.",
              "maxLength": 255,
              "minLength": 1,
              "pattern": "^[a-zA-Z0-9][a-zA-Z0-9 _.-]*$",
              "type": "string"
            }
          },
          "type": "object"
        },
        "id": {
          "description": "The integration ID",
          "format": "uuid",
          "type": "string"
        },
        "type": {
          "description": "Resource type (must be 'integration')",
          "enum": [
            "integration"
          ],
          "type": "string"
        }
      },
      "type": "object"
    }
  },
  "type": "object",
  "$defs": {
    "DigitalOceanCredentials": {
      "additionalProperties": false,
      "description": "Credentials for DigitalOcean Container Registry",
      "properties": {
        "token": {
          "description": "DigitalOcean API token with read/write access to container registry",
          "maxLength": 500,
          "minLength": 1,
          "pattern": "^[a-zA-Z0-9_-]+$",
          "type": "string"
        }
      },
      "required": [
        "token"
      ],
      "type": "object"
    },
    "DockerHubCredentials": {
      "additionalProperties": false,
      "description": "Credentials for Docker Hub container registry",
      "properties": {
        "password": {
          "description": "Docker Hub password or access token",
          "format": "password",
          "minLength": 1,
          "type": "string"
        },
        "username": {
          "description": "Docker Hub username",
          "maxLength": 255,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "username",
        "password"
      ],
      "type": "object"
    },
    "EcrCredentials": {
      "additionalProperties": false,
      "description": "Credentials for AWS Elastic Container Registry (ECR) integration",
      "properties": {
        "region": {
          "description": "AWS region where the ECR registry is located",
          "pattern": "^[a-z]{2}-[a-z]+-\\d{1}$",
          "type": "string"
        },
        "role_arn": {
          "description": "AWS IAM role ARN for cross-account access to ECR",
          "maxLength": 2048,
          "minLength": 20,
          "pattern": "^arn:aws:iam::\\d{12}:role/.+$",
          "type": "string"
        }
      },
      "required": [
        "region",
        "role_arn"
      ],
      "type": "object"
    },
    "GcrCredentials": {
      "additionalProperties": false,
      "description": "Credentials for Google Container Registry (GCR) and Google Artifact Registry (GAR)",
      "properties": {
        "password": {
          "description": "JSON key file content for Google Cloud service account (as a string)",
          "format": "password",
          "minLength": 1,
          "type": "string"
        },
        "registry_base": {
          "description": "Registry base URL for GCR or GAR (e.g., gcr.io, us.gcr.io, eu.gcr.io, asia.gcr.io, us-docker.pkg.dev, europe-docker.pkg.dev)",
          "format": "hostname",
          "maxLength": 255,
          "minLength": 1,
          "pattern": "^[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?(\\.[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?)*$",
          "type": "string"
        }
      },
      "required": [
        "password",
        "registry_base"
      ],
      "type": "object"
    },
    "GenericContainerRegistryCredentials": {
      "additionalProperties": false,
      "description": "Credentials for generic container registries (ACR, Artifactory, Harbor, Quay, etc.)",
      "properties": {
        "password": {
          "description": "Registry password or access token",
          "format": "password",
          "minLength": 1,
          "type": "string"
        },
        "registry_base": {
          "description": "Registry base URL - hostname only, no protocol (e.g., myregistry.azurecr.io, artifactory.company.com, harbor.example.com, quay.io)",
          "format": "hostname",
          "maxLength": 255,
          "minLength": 1,
          "pattern": "^[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?(\\.[a-zA-Z0-9]([a-zA-Z0-9\\-]{0,61}[a-zA-Z0-9])?)*$",
          "type": "string"
        },
        "username": {
          "description": "Registry username",
          "maxLength": 255,
          "minLength": 1,
          "type": "string"
        }
      },
      "required": [
        "username",
        "password",
        "registry_base"
      ],
      "type": "object"
    }
  }
}