Read the work. Use the sources.

Authentication

The public endpoints are read-only and need no API key or sign-in. The private notebook is not a public integration.

Quickstart

curl https://www.parasmadan.in/api/portfolio
curl -H 'Accept: text/markdown' https://www.parasmadan.in/

Endpoints

• OpenAPI 3.1.1 specification: typed operations and response schemas.
• /api/portfolio: profile, services, contact, collaborations, speaking, and articles.
• /agents/site.json: canonical URLs, topic categories, and article source links.
• /feed.json: JSON Feed 1.1 with full authored text.
• /rss.xml: publication updates in RSS 2.0.
• /sitemap.xml: canonical public pages and articles.
• /blog/{slug}/markdown: full Markdown for a published article; retrieve the slug from the content directory.

Reading and citation

Request Accept: text/markdown on the homepage, public pages, archives, or an article URL. Normal browser requests receive HTML; Markdown responses and the homepage HTML vary on Accept. Cite the canonical article URL and retain the author, dates, and supporting links. Latest in AI articles are included in the APIs and feeds while staying out of the default All blog view.

Errors

Unknown API routes return HTTP 404 with application/problem+json following RFC 9457. The body includes type, title, status, detail, instance, and the extension fields code and resolution. Unsupported public-resource methods return HTTP 405 with an Allow header. Missing pages requested as Markdown return a Markdown explanation with HTTP 404 and discovery links.

Updates and usage

Content updates after each successful repository deployment. Cache retrieved content and refresh using publication and modification dates. No contractual rate limit or uptime SLA is offered; hosting protections may return 429. Back off on failures and honor Retry-After when supplied.