drio
Technical ReviewAPI Reference

Operations

Operation CRUD for integration-backed tools.

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

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/operations"
{
  "operations": [
    {
      "id": "operation_123",
      "integrationId": "integration_123",
      "key": "search-contacts",
      "externalId": "manual:search-contacts",
      "name": "Search Contacts",
      "description": "Find contacts by email or name.",
      "method": "GET",
      "path": "/crm/v3/objects/contacts/search",
      "inputSchema": [
        {
          "name": "email",
          "type": "string",
          "description": "Email address to search for.",
          "required": false
        }
      ],
      "outputSchema": [
        {
          "name": "results",
          "type": "array",
          "description": "Matching contacts.",
          "required": true
        }
      ],
      "requestContentType": "application/json",
      "responseContentType": "application/json",
      "pathTemplate": null,
      "queryTemplate": null,
      "headerTemplate": null,
      "bodyTemplateJson": "{\"filterGroups\":[]}",
      "authSummary": "Uses app OAuth connection."
    }
  ]
}
{
  "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"
  }
}
POST
/api/v1/apps/{appId}/integrations/{integrationId}/operations

Authorization

oauth openid, profile, email
AuthorizationBearer <token>

In: header

Scope: openid, profile, email

Path Parameters

appId*string
integrationId*string

Request Body

application/json

Operation 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/string/operations" \  -H "Content-Type: application/json" \  -d '{    "name": "Search Contacts",    "method": "GET",    "path": "/crm/v3/objects/contacts/search",    "inputSchema": [      {        "name": "email",        "type": "string",        "description": "Email address to search for.",        "required": false      }    ],    "outputSchema": [      {        "name": "results",        "type": "array",        "description": "Matching contacts.",        "required": true      }    ]  }'
{
  "operation": {
    "id": "operation_123",
    "integrationId": "integration_123",
    "key": "search-contacts",
    "externalId": "manual:search-contacts",
    "name": "Search Contacts",
    "description": "Find contacts by email or name.",
    "method": "GET",
    "path": "/crm/v3/objects/contacts/search",
    "inputSchema": [
      {
        "name": "email",
        "type": "string",
        "description": "Email address to search for.",
        "required": false
      }
    ],
    "outputSchema": [
      {
        "name": "results",
        "type": "array",
        "description": "Matching contacts.",
        "required": true
      }
    ],
    "requestContentType": "application/json",
    "responseContentType": "application/json",
    "pathTemplate": null,
    "queryTemplate": null,
    "headerTemplate": null,
    "bodyTemplateJson": "{\"filterGroups\":[]}",
    "authSummary": "Uses app OAuth connection."
  }
}
{
  "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}/operations/{operationId}

Authorization

oauth openid, profile, email
AuthorizationBearer <token>

In: header

Scope: openid, profile, email

Path Parameters

appId*string
operationId*string

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://mcp.getdrio.com/api/v1/apps/string/operations/string"
{
  "operation": {
    "id": "string",
    "integrationId": "string",
    "key": "string",
    "externalId": "string",
    "name": "string",
    "description": "string",
    "method": "GET",
    "path": "string",
    "inputSchema": [
      {
        "name": "string",
        "type": "string",
        "description": "string",
        "required": true,
        "default": "string",
        "enumValues": [
          "string"
        ]
      }
    ],
    "outputSchema": [
      {
        "name": "string",
        "type": "string",
        "description": "string",
        "required": true,
        "default": "string",
        "enumValues": [
          "string"
        ]
      }
    ],
    "requestContentType": "string",
    "responseContentType": "string",
    "pathTemplate": {
      "property1": "string",
      "property2": "string"
    },
    "queryTemplate": {
      "property1": "string",
      "property2": "string"
    },
    "headerTemplate": {
      "property1": "string",
      "property2": "string"
    },
    "bodyTemplateJson": "string",
    "authSummary": "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}/operations/{operationId}

Authorization

oauth openid, profile, email
AuthorizationBearer <token>

In: header

Scope: openid, profile, email

Path Parameters

appId*string
operationId*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/operations/string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "operation": {
    "id": "string",
    "integrationId": "string",
    "key": "string",
    "externalId": "string",
    "name": "string",
    "description": "string",
    "method": "GET",
    "path": "string",
    "inputSchema": [
      {
        "name": "string",
        "type": "string",
        "description": "string",
        "required": true,
        "default": "string",
        "enumValues": [
          "string"
        ]
      }
    ],
    "outputSchema": [
      {
        "name": "string",
        "type": "string",
        "description": "string",
        "required": true,
        "default": "string",
        "enumValues": [
          "string"
        ]
      }
    ],
    "requestContentType": "string",
    "responseContentType": "string",
    "pathTemplate": {
      "property1": "string",
      "property2": "string"
    },
    "queryTemplate": {
      "property1": "string",
      "property2": "string"
    },
    "headerTemplate": {
      "property1": "string",
      "property2": "string"
    },
    "bodyTemplateJson": "string",
    "authSummary": "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}/operations/{operationId}

Authorization

oauth openid, profile, email
AuthorizationBearer <token>

In: header

Scope: openid, profile, email

Path Parameters

appId*string
operationId*string

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://mcp.getdrio.com/api/v1/apps/string/operations/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"
  }
}