Claim a link's grant in the embedded approval

POST/v1/embed/links/claim

The frame redeems the grant its Keelson window handed it. It works once, and only for the session that opened the link; the session then signs for that user.

Headers

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

Request body

application/json

grantstringRequired

Responses

200Who the frame signs for
401No live embed session, or the grant is not this session's

200 response

passkeysarray of objectRequired
credentialIdstringRequired

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

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

Response · shape from the schema

{
  "passkeys": [
    {
      "credentialId": "string",
      "payment": true
    }
  ],
  "credentialId": "string"
}