Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.rako.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
Recommendations

A recommendation records that an agent presented an eligible offer to a user. It is the core attribution event in Rako. 
POST /v1/recommend
Content-Type: application/json

​
Request

{
  "session_id": "sess_...",
  "offer_id": "offer_...",
  "context": "Best value for a cheap rolling SIM with at least 10GB"
}

​
Response

{
  "recommendation_id": "rec_...",
  "attribution_recorded": true,
  "fallback_url": "https://aap.link/r/..."
}

​
Notes

  • Create the recommendation when the agent actually recommends the offer, not when the user clicks a link.
  • Include concise context explaining why the offer was recommended.
  • Use the returned recommendation ID when initiating checkout.