MetorialDocs

Integration Instance Group Providers

Integration instance group providers define the effective routed provider set for an integration instance group.

The Integration Instance Group Provider object

integration_instance_group_provider.json
{
  "object": "integration.instance.group.provider",
  "id": "example_id",
  "status": "active",
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "integration_id": "example_integration_id",
  "integration_instance_group_id": "example_integration_instance_group_id",
  "integration_instance_id": "example_integration_instance_id",
  "integration_provider_id": "example_integration_provider_id",
  "integration_instance_provider_id": "example_integration_instance_provider_id",
  "tool_filter": {
    "type": "allow_all",
    "ignore_parent_filters": false
  },
  "is_override_tool_filter": false,
  "created_at": "2026-10-17T09:50:02.631Z",
  "updated_at": "2026-10-17T09:50:02.631Z",
  "archived_at": "2026-10-17T09:50:02.631Z"
}
object"integration.instance.group.provider"required
idstringrequired
status"active" | "archived" | "deleted"required
namestringrequired
descriptionstringrequirednullable
metadataRecord<string, any>requirednullable
integration_idstringrequired
integration_instance_group_idstringrequired
integration_instance_idstringrequired
integration_provider_idstringrequirednullable
integration_instance_provider_idstringrequired
is_override_tool_filterbooleanrequired
created_atdaterequired
updated_atdaterequired
archived_atdaterequirednullable

Endpoints

List integration instance group providers

GET/integration-instance-group-providers

Returns a paginated list of integration instance group providers.

Query parameters

status"active" | "archived" | "deleted" or "active" | "archived" | "deleted"[]optional
idstring or string[]optional
integration_instance_group_idstring or string[]optional
integration_idstring or string[]optional
integration_instance_idstring or string[]optional
integration_instance_provider_idstring or string[]optional
provider_idstring or string[]optional
integration_provider_idstring or string[]optional
provider_deployment_idstring or string[]optional
provider_config_idstring or string[]optional
provider_auth_config_idstring or string[]optional
session_template_idstring or string[]optional

Example request

curl -X GET "https://api.metorial.com/integration-instance-group-providers" \
  -H "Authorization: Bearer metorial_sk_io2h4..."

Get integration instance group provider

GET/integration-instance-group-providers/:integration_instance_group_provider_id

Retrieves a specific integration instance group provider.

Path parameters

integration_instance_group_provider_idstringrequired

The unique identifier for the integration_instance_group_provider

Example request

curl -X GET "https://api.metorial.com/integration-instance-group-providers/int_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_io2h4..."

Set integration instance group provider

PUT/integration-instance-groups/:integration_instance_group_id/providers/:integration_instance_provider_id

Creates or updates the effective integration instance group provider materialization.

Path parameters

integration_instance_group_idstringrequired

The unique identifier for the integration_instance_group

integration_instance_provider_idstringrequired

The unique identifier for the integration_instance_provider

Request body

Example request

curl -X PUT "https://api.metorial.com/integration-instance-groups/int_Rm4Mnheq2bfEPhBhP7SY/providers/int_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_io2h4..." \
  -d '{
  "tool_filters": {
    "type": "tool_keys",
    "keys": [
      "example_keys"
    ]
  }
}'

Delete integration instance group provider

DELETE/integration-instance-group-providers/:integration_instance_group_provider_id

Archives a specific integration instance group provider.

Path parameters

integration_instance_group_provider_idstringrequired

The unique identifier for the integration_instance_group_provider

Example request

curl -X DELETE "https://api.metorial.com/integration-instance-group-providers/int_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_io2h4..."