API Reference

Robi exposes a small public API behind chat.robertjeanpierre.com. The portfolio widget currently uses the ask endpoint, and the project page links to the health endpoint.

POST /ask

Ask Robi a question.

Request

{
  "question": "Tell me about SkillBridge"
}

Response

{
  "answer": "SkillBridge is ...",
  "sources": [
    {
      "title": "SkillBridge",
      "url": "https://robertjeanpierre.com/projects/skillbridge",
      "slug": "skillbridge"
    }
  ]
}

Behavior

• On strong retrieval, Robi answers from retrieved context and returns citations.
• On weak retrieval, Robi refuses instead of hallucinating.
• On provider or backend failure, the frontend shows a graceful unavailable message.

GET /health

Checks whether the backend is reachable behind Caddy.

Response shape

The endpoint returns a small health payload suitable for uptime checks and manual verification.

Frontend integration

The portfolio widget sends a JSON request to POST /ask and renders returned sources as links below the answer. Suggested prompts provide low-friction starting points, but the input accepts any question.