multi-router.aidocs

API Reference

Integrations

Guardrails, caching and telemetry: integration types, integrations, and attaching them to routers.

An integration is a configured guardrail, cache or telemetry service that runs on the requests a router serves. Each integration has a type, such as pii_regex or bedrock_guardrails, a type-specific config, behavior settings, and, for services that need one, a credential. An integration runs only on the routers it is attached to. Reading needs integrations:read, and every write, including deletes and the router attachment endpoints, needs integrations:write.

Endpoints

MethodPathDescriptionScope
GET/v1/integration-typesList every integration type, with its availability, defaults and capabilities.integrations:read
GET/v1/integration-types/{slug}Get one type.integrations:read
GET/v1/integrationsList the organization's integrations.integrations:read
POST/v1/integrationsCreate an integration. Returns 201. Accepts an Idempotency-Key.integrations:write
GET/v1/integrations/{id}Get one integration.integrations:read
PATCH/v1/integrations/{id}Change name, enabled, config, settings or credential. Requires If-Match.integrations:write
DELETE/v1/integrations/{id}Delete an integration. Requires If-Match. Returns 204. detach=true also removes it from every router.integrations:write
POST/v1/integrations/{id}/testCheck the integration's connection to its service.integrations:write
GET/v1/routers/{id}/integrationsList a router's attachments.integrations:read
POST/v1/routers/{id}/integrationsAttach an integration to a router, sent as integration_id and an optional settings_override. Returns 201.integrations:write
PATCH/v1/routers/{id}/integrations/{attachment_id}Change an attachment's enabled or settings_override. Requires If-Match.integrations:write
DELETE/v1/routers/{id}/integrations/{attachment_id}Detach an integration from the router. Requires If-Match. Returns 204.integrations:write
PUT/v1/routers/{id}/integrations/orderSet the order of the router's attachments.integrations:write
GET/v1/routers/{id}/integrations/explainList the integrations that run on the router, in the order they run.integrations:read

Integration and attachment responses return the object itself, not wrapped in data, with an integer version. The ETag header carries the same version quoted, such as "3", and If-Match accepts "3" or 3. A PATCH or DELETE without If-Match returns 428 if_match_required, and a stale one returns 412 version_conflict with the current object in current. Lists return all items at once in types, integrations or attachments, without pagination. Integration ids start with int_, and attachment ids with inta_.

Types

GET /v1/integration-types lists the types below. Each type has a category: a guardrail checks requests and answers, and can block or change them; the cache answers repeated requests; telemetry records request activity and cannot change or block a request.

TypeNameCategoryCredentialAvailable
pii_regexPII redactionguardrailNoneYes
size_limitSize limitguardrailNoneYes
secrets_detectionSecrets detectionguardrailNoneYes
prompt_judgePrompt judgeguardrailrouter_idYes
bedrock_guardrailsBedrock Guardrailsguardrailprovider_key_idYes
presidioPresidioguardrailsecret, optionalYes
azure_piiAzure PIIguardrailsecretYes
azure_content_safetyAzure Content SafetyguardrailsecretYes
model_armorModel Armorguardrailservice_accountYes
lakeraLakera GuardguardrailsecretYes
repello_argusRepello ArgusguardrailsecretYes
grayswan_cygnalGray Swan CygnalguardrailsecretYes
cacheCachecacheNoneYes
langfuseLangfusetelemetrysecretYes
s3_exportS3 exporttelemetryNone; the IAM role is in config.role_arnYes
falcon_guardianFalcon GuardianguardrailsecretNo
patronusPatronusguardrailsecretNo
singulrSingulrguardrailsecretNo
a10_guardrailsA10 GuardrailsguardrailsecretNo

Creating an integration of a type that is not available returns 400 type_not_available. Each type in the list has these fields:

FieldType
slugstring
The type, sent as type on create.
display_namestring
The name shown in the dashboard.
categorystring
guardrail, cache or telemetry.
built_inboolean
Whether Multi-Router runs the check itself, without an outside service.
availableboolean
Whether integrations of this type can be created.
capsobject
What the type supports: sides, content_kinds, actions, streaming, input_shape, spans, credential, endpoint, and for some types screening_scope.
sidesobject or null
Whether the type can check the request and the answer, as request and answer. Null for telemetry.
defaultsobject
The settings a new integration of this type starts with.
credential_kindstring
none, bedrock_provider_key, secret_required, secret_optional, assume_role, api_key, azure_key, google_service_account or router.
max_piece_with_overlapinteger or null
The largest piece_chars plus overlap_chars the type accepts. 1000 for Bedrock Guardrails.
alongside_allowed_whenstring
block_only when check_timing can be alongside_dispatch for a configuration whose action is block, or never.
editable_settingsarray
The settings a router's settings_override can set.

Creating an integration

POST /v1/integrations takes name, type and config, and optionally settings and credential. The name has 1 to 120 characters without leading or trailing spaces, and is unique in the organization. Without settings, the integration takes the type's defaults. A new integration is enabled.

Requestbash
curl -X POST https://api.multi-router.ai/v1/integrations \
  -H "Authorization: Bearer $MR_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Mask emails",
    "type": "pii_regex",
    "config": {
      "patterns": [
        { "builtin": "email", "action": "mask" },
        { "regex": "EMP-[0-9]{6}", "name": "employee_id", "action": "block" }
      ]
    }
  }'
Response 201json
{
  "id": "int_V3k9Qm2RtL",
  "name": "Mask emails",
  "type": "pii_regex",
  "category": "guardrail",
  "type_display_name": "PII redaction",
  "built_in": true,
  "enabled": true,
  "status": "active",
  "settings": {
    "enforcement": "block",
    "check_timing": "before_dispatch",
    "on_failure": "block",
    "attempt_scope": "request",
    "streaming": { "first_piece_chars": 0, "piece_chars": 0, "overlap_chars": 0, "max_hold_ms": 0 },
    "payload": "full_content",
    "timeout_ms": 50
  },
  "config": {
    "patterns": [
      { "builtin": "email", "action": "mask" },
      { "regex": "EMP-[0-9]{6}", "name": "employee_id", "action": "block" }
    ]
  },
  "credential": { "kind": "none" },
  "runs_on": [],
  "version": 1,
  "created_at": "2026-10-01T17:02:11Z",
  "updated_at": "2026-10-01T17:02:11Z"
}

Integration fields

FieldType
idstring
The integration id, prefixed int_.
namestring
1 to 120 characters, unique in the organization.
typestring
The type slug. Fixed.
categorystring
guardrail, cache or telemetry.
type_display_namestring
The type's name.
built_inboolean
Whether the type runs inside Multi-Router.
enabledboolean
Whether the integration runs. A disabled integration is skipped on every router.
statusstring
active, paused after repeated failures, or disabled.
settingsobject
Behavior settings. See Settings below.
configobject
The type-specific configuration.
credentialobject
The credential, without its secret: kind none, provider_key (provider_key_id, provider_key_name), secret (hint), router (router_id) or assume_role (role_arn, external_id).
runs_onarray
The routers it is attached to: attachment_id, router_id, router_name, position, chain_length, enabled, and custom_settings, the settings the router overrides.
deliveryobject
Telemetry only: last_delivery_at, last_delivery_result and failure_count.
versioninteger
The version, for If-Match.
created_atstring
When the integration was created.
updated_atstring
When the integration last changed.

Credentials

credential is an object with exactly one field, and is never returned. Secrets are stored encrypted, and reads show only a hint with the last four characters of a secret of 16 characters or more.

FieldTypesValue
secretpresidio, langfuse, azure_pii, azure_content_safety, lakera, repello_argus, grayswan_cygnalThe service's API key or token, up to 16 KB. For Langfuse, the secret key; the public key goes in config.
provider_key_idbedrock_guardrailsAn enabled AWS Bedrock provider key in the organization, prefixed llpk_.
router_idprompt_judgeAn enabled static router in the organization, with its model set on the router and no bound prompt. The judge sends its checks through this router.
service_accountmodel_armorA Google service account key, as the JSON object of the key file, with type service_account, client_email and private_key. Up to 64 KB.

S3 export takes no credential: Multi-Router assumes the IAM role in config.role_arn, and the response shows the role and the external_id Multi-Router generated, for the role's trust policy. Changing role_arn generates a new external id. On PATCH, a missing credential keeps the current one, an object replaces it, and null clears it, which only Presidio allows.

Settings

settings is sent whole, on create and on PATCH. Optional fields left out take the default in the table, and responses omit sides both, content_kinds of text, thinking, tool_arguments and tool_results, unchecked_media allow, log_redaction match_live, streaming.mode auto and streaming.replay_interval_ms 0. Unknown fields and values return 400.

FieldValues
enforcementblock, detect_only, logs_only
block checks live traffic and can block or change it. detect_only checks after the response and never affects live traffic; logs_only checks after the response and affects only the stored copy, and needs sides request. detect_only and logs_only are for guardrails only, and their matches are recorded as would_block in Traffic.
check_timingbefore_dispatch, alongside_dispatch
before_dispatch finishes the request check before calling the provider. alongside_dispatch calls the provider while the check runs, and returns nothing until the check passes; it needs enforcement block and a type that allows it, such as Bedrock Guardrails with action block.
on_failureblock, continue
What happens when the integration fails or times out. Guardrails can change it; other types keep continue.
attempt_scoperequest, attempt
request checks once and reuses the result on fallback attempts; attempt checks every provider attempt.
streamingobject
How streamed answers are checked: first_piece_chars, piece_chars, overlap_chars and max_hold_ms, all integers, and optionally mode (auto or whole_answer) and replay_interval_ms. whole_answer holds the whole answer and checks it once, for guardrails that check the answer. replay_interval_ms paces the release of a held answer, and needs whole_answer.
payloaddecision_context, full_content
What the integration receives: request details without message content, or the content as well.
timeout_msinteger
At least 1. Prompt judge allows up to 15000.
sidesrequest, answer, both
Optional, default both. The sides a guardrail checks, within the sides its type supports.
content_kindsarray
Optional. text, thinking, tool_definitions, tool_arguments, tool_results, images and documents, within the type's caps.content_kinds. At least one. Default text, thinking, tool_arguments and tool_results. Guardrails only.
unchecked_mediaallow, block
Optional, default allow. Whether a request with images or files the guardrail cannot check is allowed or blocked. Guardrails only.
log_redactionmatch_live, reversible
Optional, default match_live. reversible keeps the originals of redacted values, encrypted, with the stored payload, for a key with traffic:reveal; see Traffic. Only pii_regex with sides request or both.

The type's defaults set every field. Built-in guardrails start with a 50 ms timeout and per-chunk streaming; Bedrock Guardrails, Presidio and the outside guardrails start with 1500 ms and pieces of 900 characters after a first piece of 200, with 100 characters of overlap and a hold of up to 1000 ms; Lakera and Gray Swan Cygnal also check tool_definitions by default; prompt judge starts with 5000 ms and sides request; Langfuse and S3 export start with 5000 ms, payload decision_context and on_failure continue.

Config by type

Each type takes its own config. Unknown fields return 400.

pii_regex

FieldRequiredValues
patternsYes1 to 64 rules. Each rule sets exactly one of builtin or regex.
patterns[].builtinOne of builtin or regexemail, phone, credit_card, us_ssn, ip_address, aws_access_key.
patterns[].regexOne of builtin or regexUp to 512 characters. It must not match empty text, and its matches are at most 256 bytes.
patterns[].nameWith regexThe label used in placeholders, such as [EMPLOYEE_ID_1].
patterns[].actionYesmask replaces each whitespace-separated word the match touches with a numbered placeholder and restores it in the answer; block blocks the request.

size_limit

FieldRequiredValues
max_input_charsAt least one limitCharacters of message text and tool-call arguments, excluding system text and tool definitions.
max_messagesAt least one limitMessages, excluding system messages.
max_toolsAt least one limitTools.

Size limit checks the request only.

secrets_detection

FieldRequiredValues
actionNoblock or mask. Default block. mask replaces each whitespace-separated word a secret touches with [REDACTED_SECRET]; it is not restored.
ignored_keywordsNoUp to 100 strings of 1 to 128 characters.
ignored_rulesNoUp to 100 ids of detection rules to skip.
max_bytesNoThe scan window, from 1 to 1048576 bytes. Default 1048576.

prompt_judge

FieldRequiredValues
policyYesThe policy the judge model checks against, 1 to 16384 bytes.

Checking the answer with prompt judge needs streaming.mode whole_answer.

bedrock_guardrails

FieldRequiredValues
guardrail_idYesThe AWS guardrail id.
guardrail_versionYesThe guardrail version.
regionNoThe AWS region. Defaults to the provider key's region.
actionNoblock, mask or redact. Default redact. block: anything the guardrail would anonymize blocks; mask: each value the guardrail reports becomes a numbered placeholder, restored in the answer; redact: the guardrail's own anonymized text is used, not restored. block allows alongside_dispatch.

presidio

FieldRequiredValues
analyzer_urlYesThe https URL of your Presidio analyzer.
score_thresholdYesFrom 0 to 1.
actionYesblock or mask.
entitiesNoPresidio entity names to detect.

azure_pii

FieldRequiredValues
regionNoeast_us or west_europe. Default east_us.
endpointNoYour resource, as https://<resource>.cognitiveservices.azure.com, with no path or port. Replaces region.
actionNoblock or mask. Default block.
languageNoDefault en.
categoriesNoAzure PII category names. Empty checks every category.
min_scoreNoFrom 0 to 1. Default 0.5.

azure_content_safety

FieldRequiredValues
endpointYesYour resource root, on cognitiveservices.azure.com, services.ai.azure.com or api.cognitive.microsoft.com, with no path.
harm_thresholdNoFrom 1 to 7, for all four harm categories. Default 4.
analyze_textNoDefault true.
shield_promptNoDefault true.
detect_protected_materialNoDefault true.
analyze_imagesNoDefault true.

At least one of the four checks is on.

model_armor

FieldRequiredValues
project_idYesThe Google Cloud project, 1 to 63 letters, digits, hyphens or underscores.
template_idYesThe Model Armor template, 1 to 128 letters, digits, hyphens or underscores.
regionNous_central1, us_east1, us_east4, us_west1, northamerica_northeast2, europe_west1, europe_west2, europe_west3, europe_west4, europe_west9, europe_southwest1, asia_northeast1, asia_northeast3, asia_south1, asia_southeast1, australia_southeast2, eu or us. Default us_central1.
actionNoblock, mask or redact. Default block. mask needs an inspect-only template: each reported finding becomes a numbered placeholder, restored in the answer. redact needs a de-identify template: its rewritten text is used, not restored.

lakera

FieldRequiredValues
regionNous, eu or ap_southeast_1. Default us.
actionNoblock or mask. Default block.
project_idNoThe Lakera project, up to 128 characters.

repello_argus

FieldRequiredValues
asset_idYesThe Argus asset, 1 to 128 letters, digits, hyphens or underscores.

grayswan_cygnal

FieldRequiredValues
endpointYeshttps://api.grayswan.ai, with no trailing slash.
policy_idYesThe Cygnal policy, up to 128 characters.
thresholdNoGreater than 0, up to 1. Default 0.5.

cache

FieldRequiredValues
ttl_secondsYesFrom 1 to 86400.

The cache always runs closest to the provider, whatever its position on the router.

langfuse

FieldRequiredValues
hostYesThe https URL of your Langfuse host, such as https://cloud.langfuse.com.
public_keyYesThe Langfuse public key.

s3_export

FieldRequiredValues
bucketYesThe S3 bucket.
regionYesThe bucket's AWS region.
role_arnYesThe IAM role to assume, as arn:aws:iam::<12 digits>:role/<name>.
prefixNoA key prefix. Default empty.

Customer URLs, the Presidio analyzer_url and the Langfuse host, must be https with a public host name; others return 400 unsafe_url.

Changing and deleting

PATCH /v1/integrations/{id} changes the fields sent. config and settings replace the current value whole, and the result is checked again against every router the integration is attached to. enabled false stops the integration on every router.

Disable an integrationbash
curl -X PATCH https://api.multi-router.ai/v1/integrations/int_V3k9Qm2RtL \
  -H "Authorization: Bearer $MR_API_KEY" \
  -H 'If-Match: "1"' \
  -H "Content-Type: application/json" \
  -d '{ "enabled": false }'
Replace a secretbash
curl -X PATCH https://api.multi-router.ai/v1/integrations/int_8Rf2Lk5WqN \
  -H "Authorization: Bearer $MR_API_KEY" \
  -H 'If-Match: "4"' \
  -H "Content-Type: application/json" \
  -d '{ "credential": { "secret": "sk-lf-…" } }'

A DELETE of an integration that is attached to a router returns 409 integration_attached. Send ?detach=true to remove it from every router and delete it in one call.

Testing a connection

POST /v1/integrations/{id}/test checks that Multi-Router can reach and authenticate with the integration's service, without sending request content, and returns ok and latency_ms. A failed check also returns error connection_failed and a generic message, never the service's response. A check takes at most 10 seconds. Bedrock Guardrails, Presidio, S3 export, Langfuse, Azure PII, Azure Content Safety, Model Armor and Lakera check their service; PII redaction, size limit and cache check their config; other types return ok false. An organization can run 10 tests a minute and 2 at once; more return 429 test_rate_limited with Retry-After.

Response 200json
{ "ok": true, "latency_ms": 184 }

Attaching to routers

An attachment runs an integration on one router. The router endpoints take the router's rt_ id: an alias returns 400 alias_not_attachable, because an alias runs its target router's integrations. A router holds up to 99 attachments, and an integration is attached to a router once. A new attachment is enabled and goes last.

Attach an integrationbash
curl -X POST https://api.multi-router.ai/v1/routers/rt_9Hk3Ws7PzQ/integrations \
  -H "Authorization: Bearer $MR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "integration_id": "int_V3k9Qm2RtL", "settings_override": { "timeout_ms": 100 } }'
Response 201json
{
  "id": "inta_Q7m2Wd9KxP",
  "integration_id": "int_V3k9Qm2RtL",
  "name": "Mask emails",
  "type": "pii_regex",
  "category": "guardrail",
  "status": "active",
  "position": 0,
  "enabled": true,
  "sides": { "request": true, "answer": true },
  "forced_innermost": false,
  "settings_override": { "timeout_ms": 100 },
  "effective_settings": {
    "enforcement": "block",
    "check_timing": "before_dispatch",
    "on_failure": "block",
    "attempt_scope": "request",
    "streaming": { "first_piece_chars": 0, "piece_chars": 0, "overlap_chars": 0, "max_hold_ms": 0 },
    "payload": "full_content",
    "timeout_ms": 100
  },
  "version": 1
}
FieldType
idstring
The attachment id, prefixed inta_.
integration_idstring
The attached integration.
namestring
The integration's name.
typestring
The integration's type.
categorystring
guardrail, cache or telemetry.
statusstring
active, paused, or disabled when the integration or the attachment is disabled.
positioninteger
The zero-based place in the router's order.
enabledboolean
Whether the integration runs on this router.
sidesobject or null
The sides the type can check. Null for telemetry.
forced_innermostboolean
true for the cache, which runs closest to the provider whatever its position.
settings_overrideobject or null
The settings this router overrides, or null to use the integration's settings.
effective_settingsobject
The integration's settings with the override applied.
versioninteger
The version, for If-Match.

settings_override sets any of check_timing, attempt_scope, streaming, payload, sides, content_kinds and timeout_ms, with the values in Settings above. sides and content_kinds can only narrow the integration's own. enforcement and on_failure are set on the integration only, and return 400 setting_not_editable. On PATCH, a missing settings_override keeps the current one and null removes it.

Order

Request checks run in position order, and answer checks run in reverse. PUT .../order takes attachment_ids, listing every attachment on the router once, and returns attachments in the new order. A list that leaves one out or adds another returns 409 reorder_incomplete. Position cannot be changed by PATCH.

Reorderbash
curl -X PUT https://api.multi-router.ai/v1/routers/rt_9Hk3Ws7PzQ/integrations/order \
  -H "Authorization: Bearer $MR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "attachment_ids": ["inta_Q7m2Wd9KxP", "inta_3Hd8Kw2PqZ"] }'
Response 200json
{
  "attachments": [
    { "id": "inta_Q7m2Wd9KxP", "integration_id": "int_V3k9Qm2RtL", "position": 0, "…": "…" },
    { "id": "inta_3Hd8Kw2PqZ", "integration_id": "int_2Lw6Yd8NcV", "position": 1, "…": "…" }
  ]
}

Explain

GET .../explain lists the integrations that run on a request to the router, in the order they run. It follows an alias to its target, and includes the members of a fallback or weighted router. Each step has integration_id, name, category and action.

Response 200json
{
  "going_out": [
    { "integration_id": "int_V3k9Qm2RtL", "name": "Mask emails", "category": "guardrail", "action": "Checks the request" }
  ],
  "coming_back": [
    { "integration_id": "int_V3k9Qm2RtL", "name": "Mask emails", "category": "guardrail", "action": "Restores redacted values" }
  ],
  "telemetry": [
    { "integration_id": "int_8Rf2Lk5WqN", "name": "Langfuse", "category": "telemetry", "action": "Records request activity" }
  ]
}

Labels

A label is a short note a guardrail run carries about how the check ran, such as older turns being left out to fit the vendor's size limit. Labels never hold request or answer text. They are sent only to telemetry integrations: in the export record as integration_runs[].labels, in S3 export as runs[].labels (format v0) or integration_runs[].labels (format v1), and over OpenTelemetry as the span attribute multi_router.integration_run.labels.<name>. A run carries only the labels that apply.

The list is fixed and grows only with a release; a label's name and type never change. A bool label is always true when present. An integer label is a count. labels_dropped stays in the export for compatibility; with a fixed list no label is dropped.

LabelTypeSet byMeaning
context_truncatedboolLakera, Gray Swan CygnalOlder conversation turns were left out so the check fit the vendor's request size limit. The latest turn is always sent.
tool_definition_as_textboolLakera, Gray Swan CygnalTool definitions were sent to the vendor as plain text because they could not be sent in its structured tool format.
tool_result_as_textboolLakeraA tool result was sent as plain text because it had no usable tool call id.
tool_call_as_textboolLakeraA tool call was sent as plain text because its id, name or arguments were missing or not valid JSON.
tool_definitions_skipped_for_redactboolPII redactionA redact rule matched inside a tool definition. Tool definitions are never changed, so the match was left as is.
argus_flaggedboolRepello ArgusRepello flagged the content, but not with a verdict set to block, so the request went on.
secrets_redactedboolSecrets detectionOne or more secrets were masked.
pii_redactedboolPII redactionOne or more PII matches were masked.
unexpected_maskboolBedrock Guardrails, any guardrailA check that may only inspect content tried to change it, or tried to mask an image, so the run was blocked.
image_uncheckedboolBedrock GuardrailsSelected images could not be checked.
image_check_failedboolBedrock GuardrailsThe image check failed and the guardrail is set to continue on failure. The text check still applied.
cache_hitboolCacheThe answer came from the cache.
memo_checked_reuseboolAny guardrailOn a retry, the result of an earlier check of the same content was reused instead of calling the vendor again.
post_response_dropped_overloadboolAny detect_only or logs_only guardrailThe check after the response was skipped because the server was running as many of these checks as it allows.
post_response_dropped_budgetboolAny detect_only or logs_only guardrailThe check after the response was skipped because the time allowed for these checks ran out.
post_response_cancelled_shutdownboolAny detect_only or logs_only guardrailThe check after the response was stopped because the server was shutting down.
answer_check_skipped_streamboolAny detect_only or logs_only guardrailThe answer was not checked because the request was streamed and the full answer text was not captured. Streamed answers are normally checked once they end.
answer_check_skipped_cut_shortboolAny detect_only or logs_only guardrailThe answer was not checked because it was cut short, was blocked, or was produced by Multi Router itself rather than the model (for example a cache hit). The name predates the last two cases and is kept for compatibility.
answer_check_skipped_unreadableboolAny detect_only or logs_only guardrailThe answer was not checked because it could not be read.
answer_check_skipped_request_failureboolAny detect_only or logs_only guardrailThe answer was not checked because the request to the model failed.
tool_definitions_omittedintegerLakera, Gray Swan Cygnal, Azure Content Safety, Azure PII, Model Armor, Repello ArgusHow many tool definitions were not sent to the vendor because the request had more than 128 of them, or more than 256 KiB.
unchecked_imagesintegerEvery guardrail run on the requestHow many images in the request no attached guardrail checked.
unchecked_filesintegerEvery guardrail run on the requestHow many files in the request no attached guardrail checked.

Errors

Config and settings errors return 400 with the field at fault and a code such as invalid_config, unknown_field, required, invalid_value, out_of_range, https_required, invalid_regex or setting_not_editable. Other errors:

CodeStatusMeaning
invalid_integration400An unknown type, or a credential that does not fit the type.
invalid_input400The body has an unknown field or a field of the wrong type.
type_not_available400The type is not available.
credential_required400A PATCH clears a credential the type requires.
invalid_router400The prompt judge router is not an enabled static router with its model set and no bound prompt.
provider_key_not_found400The provider key is absent from the organization.
provider_key_not_supported400The provider key is disabled or not an AWS Bedrock key, or the type takes no provider key.
unsafe_url400A customer URL is not allowed.
alias_not_attachable400The router id is an alias. Use the rt_ id of its target.
not_found404No integration, type, attachment or router has that id in the organization.
duplicate_name409Another integration has the name.
integration_attached409A DELETE names an attached integration. Detach it, or send detach=true.
already_attached409The integration is already attached to the router.
too_many_attachments409The router has 99 attachments.
reorder_incomplete409The order does not list every attachment on the router exactly once.
written_by_newer_version409The integration was saved with settings this server cannot change. Retry later.
version_conflict412The If-Match version is stale. current holds the current object.
if_match_required428A PATCH or DELETE has no If-Match.
test_rate_limited429Too many connection tests. Retry after Retry-After seconds.
integration_unavailable503Integrations are unavailable. Retry.
Provider KeysModel Groups
Was this helpful?