Integration Providers

Integration providers define the shared provider-level contract for a given integration.

Integration Providers object

Attributes

object

String

id

String

status

Enum

integration_id

String

name

String

description

StringNullable

metadata

ObjectNullable

A key-value map

tool_filter

ObjectNullable

Tool filter configuration

provider_id

String

deployment_id

String

auth_method_id

StringNullable

auth_credentials_id

StringNullable

config

ObjectNullable

created_at

Date

updated_at

Date

archived_at

DateNullable
{
  "object": "integration.provider",
  "status": "active",
  "metadata": {},
  "tool_filter": {
    "type": "allow_all"
  },
  "config": {
    "object": "provider.config#preview",
    "id": "pcf_7dEfGhJkLmNpQrSt",
    "name": "Production Config",
    "description": "Configuration for production environment",
    "metadata": {},
    "provider_id": "pro_5gHjKlMnPqRsTuVw",
    "created_at": "2025-09-15T10:30:00.000Z",
    "updated_at": "2026-01-10T14:45:00.000Z"
  }
}

List integration providers

Returns a paginated list of integration providers.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

search

StringOptional

status

UnionOptional

id

UnionOptional

integration_id

UnionOptional

provider_id

UnionOptional

provider_deployment_id

UnionOptional

provider_auth_method_id

UnionOptional

provider_auth_credentials_id

UnionOptional

provider_config_id

UnionOptional

created_at

ObjectOptional

Filter integration provider creation time by date range

updated_at

ObjectOptional

Filter integration provider last update time by date range

GEThttp://api.metorial.com/integration-providers
curl -X GET "https://api.metorial.com/integration-providers" \
  -H "Authorization: Bearer metorial_sk_..."

Get integration provider

Retrieves a specific integration provider.

URL Parameters

integration_provider_id

String

The unique identifier for the integration_provider

GEThttp://api.metorial.com/integration-providers/:integration_provider_id
curl -X GET "https://api.metorial.com/integration-providers/int_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."

Create integration provider

Creates a new integration provider.

Request Body

integration_id

String

provider_id

String

provider_deployment_id

String

provider_auth_method_id

StringOptionalNullable

provider_auth_credentials_id

StringOptionalNullable

provider_config_id

StringOptionalNullable

name

StringOptional

description

StringOptional

metadata

ObjectOptional

A key-value map

tool_filters

UnionOptionalNullable
POSThttp://api.metorial.com/integration-providers
curl -X POST "https://api.metorial.com/integration-providers" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "integration_id": "example_integration_id",
  "provider_id": "example_provider_id",
  "provider_deployment_id": "example_provider_deployment_id",
  "provider_auth_method_id": "example_provider_auth_method_id",
  "provider_auth_credentials_id": "example_provider_auth_credentials_id",
  "provider_config_id": "example_provider_config_id",
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "tool_filters": {
    "type": "example_type",
    "keys": [
      "example_item"
    ]
  }
}'

Update integration provider

Updates a specific integration provider.

URL Parameters

integration_provider_id

String

The unique identifier for the integration_provider

Request Body

provider_deployment_id

StringOptional

provider_auth_method_id

StringOptionalNullable

provider_auth_credentials_id

StringOptionalNullable

provider_config_id

StringOptionalNullable

name

StringOptional

description

StringOptionalNullable

metadata

ObjectOptionalNullable

A key-value map

tool_filters

UnionOptionalNullable
PATCHhttp://api.metorial.com/integration-providers/:integration_provider_id
curl -X PATCH "https://api.metorial.com/integration-providers/int_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "provider_deployment_id": "example_provider_deployment_id",
  "provider_auth_method_id": "example_provider_auth_method_id",
  "provider_auth_credentials_id": "example_provider_auth_credentials_id",
  "provider_config_id": "example_provider_config_id",
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "tool_filters": {
    "type": "example_type",
    "keys": [
      "example_item"
    ]
  }
}'

Delete integration provider

Archives a specific integration provider.

URL Parameters

integration_provider_id

String

The unique identifier for the integration_provider

DELETEhttp://api.metorial.com/integration-providers/:integration_provider_id
curl -X DELETE "https://api.metorial.com/integration-providers/int_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."