Initiate device authorization

Start quick connect. Agents should call this first, then direct the user to verification_uri_complete. Do not start by scraping /connect.

post/api/agent-auth/device

Request

Base URL: https://goyondo.run
URL: https://goyondo.run/api/agent-auth/device
Auth: none required

Request body

agent_namestring required

requested_scopesstring[] required

Example request

{
  "agent_name": "My Travel Agent",
  "requested_scopes": [
    "trips:read",
    "trips:write"
  ]
}

Response

Device authorization request created

user_codestring

verification_urlstring uri

verification_uri_completestring uri

device_codestring

expires_ininteger

intervalinteger

Example response

{
  "user_code": "GYD-A3F9",
  "verification_url": "https://goyondo.run/connect",
  "verification_uri_complete": "https://goyondo.run/connect?code=GYD-A3F9",
  "device_code": "<opaque 64-char hex>",
  "expires_in": 600,
  "interval": 5
}

Changes

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