Skip to main content
POST
Start a sign-in from the agent's side

Authorizations

Authorization
string
header
required

Agent token (alt_…) or OAuth access token; bound to one agent

Body

application/json
client_id
string

The application to sign in to: its client_id (alap_…) from the directory, or an HTTPS origin for an open client. Omit to only enrol a browser for this agent

Required string length: 1 - 2048
scope
enum<string>[]

Scopes to grant the application now (default openid, email, profile). Owner scopes need identity:share_owner and a registered application

Maximum array length: 5
Available options:
openid,
email,
profile,
owner_profile,
owner_email

Response

Connect link

url
string
required

Single-use link, valid five minutes: the browser that opens it holds a sign-in key of the agent and continues to the application

expires_at
string<date-time>
required
app_login_url
string | null
required

The application's login start with iss and login_hint, for an agent that follows redirects itself; null when the application has none

application
object | null
required
granted_scope
enum<string>[]
required

What the application was granted now; empty when no application was named

Available options:
openid,
email,
profile,
owner_profile,
owner_email