Skip to main content
POST
Get auth URL

Authorizations

x-api-key
string
header
required

Kylon agent API credential. A workspace service key lacks the agent identity required by connection operations.

Body

application/json
toolkit
string
required

Toolkit slug (from search results).

scopes
string[]

Optional provider-specific OAuth scopes.

redirect_url
string

Agent-started proxy authorization uses Kylon's connection popup callback; this field does not override it.

connection_intent
object

Why authorization is requested. Missing or malformed intent normalizes to unknown; scheduled_digest without cadence is rejected.

Response

Successful response

redirectUrl
string
required

URL to open in a browser to complete the OAuth flow.

agentInstruction
string
required

Instructions for presenting the authorization link.