Generate a tool integration OAuth URL

Generate a Runbear-hosted OAuth URL for an integration that needs browser-based authorization (step two of the two-step OAuth flow). The caller opens authUrl in a browser; Runbear completes the handshake server-side. authUrl is null when the integration is already authorized. Returns 400 auth_url_not_applicable for rows that need no browser auth (Pipedream none/null, Managed MCP stdio, remote/custom MCP with auth.type none/static), 400 when the agent's provider does not support tool integrations, and 404 when the agent or integration is not found.

post/v1/agents/{id}/tool-integrations/{integrationId}/auth-url

Request

  • Base URL
    https://api.runbear.io
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

Agent ID

integrationIdstring uuid required

Tool integration ID

Response

Default Response

authUrlstring uri nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.