Find the best way to act in an app

What to do when your agent should act in an app: route is the best way there, with why and the next step, and alternatives are the others, best first. The order is a catalogue integration, the vendor’s own MCP server when its publisher is verified as the vendor, an OpenAPI import, then a custom action. It works for any name and only suggests: nothing is registered, adopted or connected. Any credential may ask, since it reads nothing of the workspace’s. query and any name in the text come from the caller: show them as text.

GET/api/v2/connections/integrations/find

Authorization

AuthorizationBearer token (Anlyon API key) · headerrequired

Workspace API key sent as Authorization: Bearer <key>.

better-auth.session_tokenAPI key · cookierequired

Browser session used by dashboard-only operations.

Query parameters

namestringrequired

The app's name

min length 1 · max length 200

Header parameters

X-Request-Idstring

Optional caller correlation ID. Unsafe or oversized values are replaced.

max length 128

Responses

200

The best route and the others.

successbooleanrequired

Allowed:true

dataobjectrequired

Show properties

querystringrequired

The name as it was asked for. Untrusted

namestringrequired

The vendor's own spelling when it is known

routeIntegrationRouterequired

One way to act in an app.

Show properties

kindstringrequired

integration: connect an account for a catalogue integration. mcp: add the vendor's own MCP server, whose publisher is verified as the vendor. openapi: import an OpenAPI spec. mcp_address: add a server by an address you bring. custom_action: declare an action on the app's HTTP API.

Allowed:integrationmcpopenapimcp_addresscustom_action

whystringrequired

One sentence on why this route.

nextErrorFixrequired

How to get past this error, for a person or an agent. Present on refusals with a known next step, such as a missing scope or role, a plan or billing limit, a halted environment, or a missing secret, connected account, OAuth app or end-user header. Absent when there is no fix to give. Kept in production responses, unlike details.

Show properties

summarystringrequired

One sentence that says what to do.

commandstring

An exact anlyon CLI command that fixes it. Absent when no command does.

urlstring<uri>

An absolute console link where a person fixes it.

docsstring<uri>

A docs page that explains it.

integrationobject

Show properties

idstringrequired

connectstringrequired

Allowed:sign_inapi_key

mcpobject

Show properties

registryNamestringrequired

urlstring<uri>required

hoststringrequired

publisherobjectrequired

Show properties

verifiedBystringrequired

How the MCP Registry verified the namespace.

Allowed:domaingithub

namespacestringrequired

reportstring<uri>required

What anlyon.dev reports about the server's tools.

alternativesIntegrationRoute[]required

The other routes, best first.

Show properties

Array of IntegrationRoute

kindstringrequired

Allowed:integrationmcpopenapimcp_addresscustom_action

whystringrequired

One sentence on why this route.

nextErrorFixrequired

Show properties

summarystringrequired

One sentence that says what to do.

commandstring

An exact anlyon CLI command that fixes it. Absent when no command does.

urlstring<uri>

An absolute console link where a person fixes it.

docsstring<uri>

A docs page that explains it.

integrationobject

Show properties

idstringrequired

connectstringrequired

Allowed:sign_inapi_key

mcpobject

Show properties

registryNamestringrequired

urlstring<uri>required

hoststringrequired

publisherobjectrequired

Show properties

verifiedBystringrequired

How the MCP Registry verified the namespace.

Allowed:domaingithub

namespacestringrequired

reportstring<uri>required

What anlyon.dev reports about the server's tools.

tellUsstringrequired

Where to ask for an integration.

400

Bad Request - Invalid input data

successbooleanrequired

requestIdstringrequired

Correlation ID matching the X-Request-Id response header.

errorobjectrequired

Show properties

codestring

messagestring

detailsobject

fixErrorFix

Show properties

summarystringrequired

One sentence that says what to do.

commandstring

An exact anlyon CLI command that fixes it. Absent when no command does.

urlstring<uri>

An absolute console link where a person fixes it.

docsstring<uri>

A docs page that explains it.

401

Unauthorized - Invalid or missing API key

successbooleanrequired

requestIdstringrequired

Correlation ID matching the X-Request-Id response header.

errorobjectrequired

Show properties

codestring

messagestring

detailsobject

fixErrorFix

Show properties

summarystringrequired

One sentence that says what to do.

commandstring

An exact anlyon CLI command that fixes it. Absent when no command does.

urlstring<uri>

An absolute console link where a person fixes it.

docsstring<uri>

A docs page that explains it.

404

Not Found - Resource does not exist

successbooleanrequired

requestIdstringrequired

Correlation ID matching the X-Request-Id response header.

errorobjectrequired

Show properties

codestring

messagestring

detailsobject

fixErrorFix

Show properties

summarystringrequired

One sentence that says what to do.

commandstring

An exact anlyon CLI command that fixes it. Absent when no command does.

urlstring<uri>

An absolute console link where a person fixes it.

docsstring<uri>

A docs page that explains it.

429

Too Many Requests - Rate limit exceeded. A workspace's API requests are limited per minute and per UTC clock hour by plan; Retry-After says when to try again, and an hourly refusal names the limit and when the count resets. Successful responses carry the same limits in X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (the minute) and X-RateLimit-Limit-Hour, X-RateLimit-Remaining-Hour, X-RateLimit-Reset-Hour (the hour).

successbooleanrequired

requestIdstringrequired

Correlation ID matching the X-Request-Id response header.

errorobjectrequired

Show properties

codestring

messagestring

detailsobject

fixErrorFix

Show properties

summarystringrequired

One sentence that says what to do.

commandstring

An exact anlyon CLI command that fixes it. Absent when no command does.

urlstring<uri>

An absolute console link where a person fixes it.

docsstring<uri>

A docs page that explains it.

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (Anlyon API key)Remember on this deviceInclude my values in samples

Parameters

X-Request-IdheaderOptional caller correlation ID. Unsafe or oversized values are replaced.namequery*The app's name

Request

curl -X GET 'https://api.anlyon.com/api/v2/connections/integrations/find?name=string' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json'

const response = await fetch("https://api.anlyon.com/api/v2/connections/integrations/find?name=string", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json"
  }
});

import requests

response = requests.get(
    "https://api.anlyon.com/api/v2/connections/integrations/find?name=string",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Accept": "application/json"
    },
)

Response

{
  "success": true,
  "data": {
    "query": "string",
    "name": "string",
    "route": {
      "kind": "integration",
      "why": "string",
      "next": {
        "summary": "Log in again and approve the anlyon:secrets consent group, which grants secrets:write.",
        "command": "anlyon auth login --scope anlyon:secrets",
        "url": "https://console.anlyon.com/settings/api-keys",
        "docs": "https://docs.anlyon.com/cli/authentication"
      },
      "integration": {
        "id": "stripe",
        "connect": "sign_in"
      },
      "mcp": {
        "registryName": "com.example/mcp",
        "url": "https://mcp.example.com/mcp",
        "host": "mcp.example.com",
        "publisher": {
          "verifiedBy": "domain",
          "namespace": "com.example"
        },
        "report": "http://example.com"
      }
    },
    "alternatives": [
      {
        "kind": "integration",
        "why": "string",
        "next": {
          "summary": "Log in again and approve the anlyon:secrets consent group, which grants secrets:write.",
          "command": "anlyon auth login --scope anlyon:secrets",
          "url": "https://console.anlyon.com/settings/api-keys",
          "docs": "https://docs.anlyon.com/cli/authentication"
        },
        "integration": {
          "id": "stripe",
          "connect": "sign_in"
        },
        "mcp": {
          "registryName": "com.example/mcp",
          "url": "https://mcp.example.com/mcp",
          "host": "mcp.example.com",
          "publisher": {
            "verifiedBy": "domain",
            "namespace": "com.example"
          },
          "report": "http://example.com"
        }
      }
    ],
    "tellUs": "string"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request data",
    "details": {
      "url": "Invalid URL format"
    }
  }
}

{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_ERROR",
    "message": "Invalid or missing API key"
  }
}

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found"
  }
}

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Rate limit exceeded. Please try again later."
  }
}