Embed the approval of a request

POST/v1/connections/embed

For a pending request this client made, a URL to frame in the agent platform's page at origin, one of the client's embed origins. The URL's fragment carries a single-use token the frame redeems within five minutes; mint another to frame it again. The user approves in a Keelson window the frame opens, with a passkey; poll POST /v1/connections/token as usual for the answer.

Headers

Content-Typeapplication/jsonRequired
Idempotency-KeystringRequired: 1 to 255 characters. A retry with the same key returns the first answer.

Request body

application/json

device_codestringRequired
originstringRequired

Responses

201Frame url; it opens to the request
401No valid access token
403The origin is not one of this client's
404No pending request with this device code

201 response

urlstringRequired
refstringRequired
expires_inintegerRequired

curl -X POST https://api.keelson.finance/v1/connections/embed \
  -H 'content-type: application/json' \
  -H "idempotency-key: $(uuidgen)" \
  --data '{"device_code":"string","origin":"string"}'

const res = await fetch("https://api.keelson.finance/v1/connections/embed", {
  method: "POST",
  headers: {
    "content-type": "application/json",
    "idempotency-key": crypto.randomUUID(),
  },
  body: JSON.stringify({
    "device_code": "string",
    "origin": "string"
  }),
});
const data = await res.json();

Response · shape from the schema

{
  "url": "string",
  "ref": "string",
  "expires_in": 0
}