drio
Open app
Technical ReviewAPI Reference

Integrations

Integration connection CRUD for a specific app.

GET
/api/v1/apps/{appId}/integrations

Authorization

oauth openid, profile, email
AuthorizationBearer <token>

In: header

Scope: openid, profile, email

Path Parameters

appId*string

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://mcp.getdrio.com/api/v1/apps/string/integrations"
{
  "integrations": [
    {
      "id": "integration_123",
      "appId": "app_123",
      "key": "hubspot-main",
      "name": "HubSpot",
      "kind": "rest",
      "providerId": "integration_provider_123",
      "providerKey": "custom-http",
      "providerName": "Custom HTTP",
      "authId": "auth_123",
      "endpoint": "https://api.hubapi.com",
      "baseUrl": "https://api.hubapi.com",
      "title": "HubSpot API",
      "specVersion": "3.0.3",
      "discoveryWarnings": [],
      "status": "ready",
      "lastDiscoveredAt": "2026-03-15T12:00:00.000Z",
      "lastError": null
    }
  ],
  "providers": [
    {
      "id": "integration_provider_123",
      "key": "custom-http",
      "name": "Custom HTTP",
      "kind": "rest",
      "docsUrl": "https://docs.getdrio.com/custom-http",
      "authProviderKeys": [
        "custom-oauth"
      ],
      "discoveryMode": "manual",
      "operationShapeVersion": "1",
      "supportsUserDefinedEndpoints": true
    }
  ]
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
  }
}
POST
/api/v1/apps/{appId}/integrations

Authorization

oauth openid, profile, email
AuthorizationBearer <token>

In: header

Scope: openid, profile, email

Path Parameters

appId*string

Request Body

application/json

Integration payload

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://mcp.getdrio.com/api/v1/apps/string/integrations" \  -H "Content-Type: application/json" \  -d '{    "name": "HubSpot",    "kind": "rest",    "providerKey": "custom-http",    "authId": "auth_123",    "endpoint": "https://api.hubapi.com",    "baseUrl": "https://api.hubapi.com",    "status": "ready"  }'
{
  "integration": {
    "id": "integration_123",
    "appId": "app_123",
    "key": "hubspot-main",
    "name": "HubSpot",
    "kind": "rest",
    "providerId": "integration_provider_123",
    "providerKey": "custom-http",
    "providerName": "Custom HTTP",
    "authId": "auth_123",
    "endpoint": "https://api.hubapi.com",
    "baseUrl": "https://api.hubapi.com",
    "title": "HubSpot API",
    "specVersion": "3.0.3",
    "discoveryWarnings": [],
    "status": "ready",
    "lastDiscoveredAt": "2026-03-15T12:00:00.000Z",
    "lastError": null
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
  }
}
GET
/api/v1/apps/{appId}/integrations/{integrationId}

Authorization

oauth openid, profile, email
AuthorizationBearer <token>

In: header

Scope: openid, profile, email

Path Parameters

appId*string
integrationId*string

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://mcp.getdrio.com/api/v1/apps/string/integrations/string"
{
  "integration": {
    "id": "string",
    "appId": "string",
    "key": "string",
    "name": "string",
    "kind": "mcp",
    "providerId": "string",
    "providerKey": "string",
    "providerName": "string",
    "authId": "string",
    "endpoint": "string",
    "baseUrl": "string",
    "title": "string",
    "specVersion": "string",
    "discoveryWarnings": [
      "string"
    ],
    "status": "draft",
    "lastDiscoveredAt": "string",
    "lastError": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
  }
}
PATCH
/api/v1/apps/{appId}/integrations/{integrationId}

Authorization

oauth openid, profile, email
AuthorizationBearer <token>

In: header

Scope: openid, profile, email

Path Parameters

appId*string
integrationId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://mcp.getdrio.com/api/v1/apps/string/integrations/string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "integration": {
    "id": "string",
    "appId": "string",
    "key": "string",
    "name": "string",
    "kind": "mcp",
    "providerId": "string",
    "providerKey": "string",
    "providerName": "string",
    "authId": "string",
    "endpoint": "string",
    "baseUrl": "string",
    "title": "string",
    "specVersion": "string",
    "discoveryWarnings": [
      "string"
    ],
    "status": "draft",
    "lastDiscoveredAt": "string",
    "lastError": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
  }
}
DELETE
/api/v1/apps/{appId}/integrations/{integrationId}

Authorization

oauth openid, profile, email
AuthorizationBearer <token>

In: header

Scope: openid, profile, email

Path Parameters

appId*string
integrationId*string

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://mcp.getdrio.com/api/v1/apps/string/integrations/string"
{
  "deleted": true
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "details": null,
    "requestId": "d385ab22-0f51-4b97-9ecd-b8ff3fd4fcb6"
  }
}

Deployments

Previous Page

Operations

Next Page