Sign in
Connectors

Get connector detail

Changed on

Returns connector detail, connection status, allowlisted tools, and approval policies for this Monet install.

get/api/connectors/{connectorId}

Request

  • The document declares no server URL.
  • Auth: none declared

Path parameters

connectorIdstring required
Example:github

Response

Connector fetched successfully.

Example response

{
  "connector": {
    "id": "github",
    "displayName": "GitHub",
    "description": "Search repositories, issues, pull requests, commits, and releases.",
    "category": "developer",
    "icon": "github",
    "featuredTools": [
      "GITHUB_SEARCH_ISSUES_AND_PULL_REQUESTS"
    ],
    "enabledByDefault": true,
    "minimumApprovalPolicy": {
      "sideEffect": "read",
      "approval": "never"
    },
    "capabilitySummaries": [
      "Search and list repositories."
    ],
    "status": "not_connected",
    "connectedAccountLabel": "octocat",
    "lastErrorCode": "provider_error",
    "lastErrorMessage": "Connector provider is not configured.",
    "providerConnectorId": "GITHUB",
    "connection": {
      "status": "connected",
      "connected": true,
      "connectedAccountLabel": "octocat",
      "account": {
        "accountLabel": "octocat",
        "accountId": "123456",
        "providerConnectionId": "conn_123",
        "providerConnectorId": "GITHUB",
        "connectedAt": "2026-04-27T10:00:00.000Z",
        "updatedAt": "2026-04-27T10:05:00.000Z"
      },
      "lastErrorCode": "connection_expired",
      "lastErrorMessage": "Connector account credentials have expired."
    },
    "allowedTools": [
      {
        "providerToolId": "GITHUB_SEARCH_ISSUES_AND_PULL_REQUESTS",
        "displayName": "Search issues and pull requests",
        "summary": "Search issues and pull requests across accessible repositories.",
        "policy": {
          "sideEffect": "read",
          "approval": "never"
        }
      }
    ]
  }
}

Changes