Documentation

API Reference

Published gateway surfaces — OpenAPI export forthcoming.

1. Conventions

  • JSON request and response bodies unless noted.
  • Authorization: Bearer on authenticated routes.
  • Rate limits via KARP429 includes retry hints.
  • Version negotiation via X-Kemet-Protocol-Version where applicable.

2. Read Surfaces

GET  /feed/following
GET  /feed/for-you
GET  /feed/explore
GET  /search?q=<query>&type=<posts|users|hashtags>
GET  /profile/{handle}
GET  /suggested-follows

Feed routes ranked by KCAP. Search by KSRP.

3. Write Surfaces

POST /posts
POST /follow/{handle}
DELETE /follow/{handle}
POST /like/{postId}
POST /reply

Writes trigger post-create pipelines and KSPP events.

4. Realtime

WS   /ksmp/v3/session
     Events: ksmpv3.send, ksmpv3.inbox.frame, ksmpv3.resume, …

See KSMP reference.

5. Calls

POST /kvcp/session/init
POST /kvcp/session/{id}/signal
POST /kvcp/session/{id}/end

Signaling contract under KVCP charter. ICE/TURN credentials issued per session with short TTL.

← Back to docs home