Skip to main content
PUT
/
api
/
v1
/
custom-integrations
/
{integration_id}
Update Custom Integration
curl --request PUT \
  --url https://control-plane.kubiya.ai/api/v1/custom-integrations/{integration_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "integration_type": "<string>",
  "description": "<string>",
  "config": {
    "context_prompt": "Production PostgreSQL database. Use connection pooling.",
    "env_vars": {
      "DB_HOST": "postgres.prod.example.com",
      "DB_NAME": "production",
      "DB_PORT": "5432"
    },
    "files": [
      {
        "mode": "0600",
        "path": "~/.postgresql/client.crt",
        "secret_ref": "POSTGRES_CLIENT_CERT"
      }
    ],
    "secrets": [
      "DB_PASSWORD",
      "DB_SSL_CERT"
    ]
  },
  "status": "active",
  "tags": [
    "<string>"
  ]
}
'
{
  "id": "<string>",
  "organization_id": "<string>",
  "name": "<string>",
  "integration_type": "<string>",
  "description": "<string>",
  "status": "<string>",
  "config": {},
  "tags": [
    "<string>"
  ],
  "created_at": "<string>",
  "updated_at": "<string>",
  "created_by": "<string>"
}

Authorizations

Authorization
string
header
required

Enter your Kubiya API token (format: Bearer )

Path Parameters

integration_id
string
required

Body

application/json

Request to update a custom integration

name
string | null
Required string length: 1 - 255
integration_type
string | null
Required string length: 1 - 100
description
string | null
config
CustomIntegrationConfig · object

Custom integration configuration

Example:
{
"context_prompt": "Production PostgreSQL database. Use connection pooling.",
"env_vars": {
"DB_HOST": "postgres.prod.example.com",
"DB_NAME": "production",
"DB_PORT": "5432"
},
"files": [
{
"mode": "0600",
"path": "~/.postgresql/client.crt",
"secret_ref": "POSTGRES_CLIENT_CERT"
}
],
"secrets": ["DB_PASSWORD", "DB_SSL_CERT"]
}
status
enum<string> | null

Custom integration status

Available options:
active,
inactive,
deleted
tags
string[] | null

Response

Successful Response

Custom integration response

id
string
required
organization_id
string
required
name
string
required
integration_type
string
required
description
string | null
required
status
string
required
config
Config · object
required
tags
string[]
required
created_at
string
required
updated_at
string
required
created_by
string | null
required