Read a link in the Keelson window

POST/v1/embed/links/inspect

The agent platform and the request an unspent link was opened for, so the window can show the user which page they are about to link before they confirm.

Headers

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

Request body

application/json

noncestringRequired

Responses

200The link
401Not signed in
404The link is unknown, spent or expired

200 response

noncestringRequired
expires_inintegerRequired

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

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

Response · shape from the schema

{
  "nonce": "string",
  "expires_in": 0
}