Integrations

Browse the team's catalog of available integration types

get

List the team's integration catalog: built-in integration types plus any custom connection types defined for the team. OAuth authorization flows are browser-based and cannot be performed via this API; use the Duvo dashboard to complete OAuth-based connections.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Query parameters

typestringOptional

limitinteger · min: 1 · max: 100OptionalDefault: 100

offsetinteger · max: 9007199254740991Optional

Responses

200

Default Response

application/json

totalinteger · max: 9007199254740991Required

limitinteger · min: 1 · max: 9007199254740991Required

offsetinteger · max: 9007199254740991Required

401

Default Response

application/json

500

Default Response

application/json

get

/v1/integrations

HTTPcURLJavaScriptPython

GET /v1/integrations HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "integrations": [
    {
      "id": "text",
      "name": "text",
      "type": "text",
      "provider": "text",
      "user_id": "text",
      "team_id": "text",
      "server_url": "text",
      "transport_type": "stdio",
      "auth_method": "text",
      "composio_mcp_id": "text",
      "custom_integration_id": "text",
      "icon_url": "text",
      "oauth_provider": "text",
      "oauth_scopes": [
        "text"
      ],
      "has_headers": true,
      "has_oauth_tokens": true,
      "integration_id": "text",
      "shared": true,
      "created_by": "text",
      "created_at": "2026-05-20T03:19:49.272Z",
      "updated_at": "2026-05-20T03:19:49.272Z"
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1
}

post

Create a custom integration type (team-level catalog entry) that users can then connect as user-provided MCP connections. Requires manager-or-above role.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Body

application/json

namestring · min: 1Required

auth_methodstring · enumRequiredPossible values:

server_urlstring · uriRequired

oauth_client_idstring · min: 1Optional

oauth_client_secretstring · min: 1Optional

Responses

201

Default Response

application/json

400

Default Response

application/json

401

Default Response

application/json

403

Default Response

application/json

409

Default Response

application/json

500

Default Response

application/json

post

/v1/integrations/custom

HTTPcURLJavaScriptPython

POST /v1/integrations/custom HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 124

{
  "name": "text",
  "auth_method": "url",
  "server_url": "https://example.com",
  "oauth_client_id": "text",
  "oauth_client_secret": "text"
}

{
  "id": "text",
  "name": "text",
  "type": "text",
  "provider": "text",
  "user_id": "text",
  "team_id": "text",
  "server_url": "text",
  "transport_type": "stdio",
  "auth_method": "text",
  "composio_mcp_id": "text",
  "custom_integration_id": "text",
  "icon_url": "text",
  "oauth_provider": "text",
  "oauth_scopes": [
    "text"
  ],
  "has_headers": true,
  "has_oauth_tokens": true,
  "integration_id": "text",
  "shared": true,
  "created_by": "text",
  "created_at": "2026-05-20T03:19:49.272Z",
  "updated_at": "2026-05-20T03:19:49.272Z"
}

delete

Delete a custom integration type (team-level catalog entry) and cascade-remove related connections. Requires manager-or-above role.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Path parameters

custom_integration_idstring · uuidRequired

Custom integration type ID

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$

Responses

200

Default Response

application/json

successbooleanRequired

messagestringRequired

400

Default Response

application/json

401

Default Response

application/json

403

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

delete

/v1/integrations/custom/{custom_integration_id}

HTTPcURLJavaScriptPython

DELETE /v1/integrations/custom/{custom_integration_id} HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true,
  "message": "text"
}