Skip to content

Users

Endpoints in the Users group. All paths are relative to https://rmhstudios.com.

GET/api/v1/users/{handle}read:users

A public user profile by handle.

Parameters

  • handle (path, required) — The user’s handle (without @).

Example response

{
  "id": "ck_user123",
  "name": "Ada",
  "handle": "ada",
  "image": "https://…",
  "bio": "builder",
  "createdAt": "2026-01-02T03:04:05.000Z",
  "stats": {
    "followers": 12,
    "following": 30,
    "posts": 88,
    "level": 7
  }
}
GET/api/v1/users/{handle}/postsread:users

A user’s public posts, newest first.

Parameters

  • handle (path, required) — The user’s handle.
  • limit (query) — Page size, 1–50 (default 20).
  • cursor (query) — Opaque cursor from a previous `nextCursor` to fetch the next page.

Example response

{
  "data": [
    {
      "id": "ck_post123",
      "content": "hello world",
      "audience": "PUBLIC",
      "createdAt": "2026-06-30T10:00:00.000Z",
      "metrics": {
        "likes": 3,
        "comments": 1,
        "reposts": 0,
        "views": 42
      },
      "author": {
        "id": "ck_user123",
        "name": "Ada",
        "handle": "ada",
        "image": "https://…"
      }
    }
  ],
  "nextCursor": null
}
GET/api/v1/users/{handle}/followersread:users

Users who follow this user.

Parameters

  • handle (path, required) — The user’s handle.
  • limit (query) — Page size, 1–50 (default 20).
  • cursor (query) — Opaque cursor from a previous `nextCursor` to fetch the next page.

Example response

{
  "data": [
    {
      "id": "ck_user123",
      "name": "Ada",
      "handle": "ada",
      "image": "https://…"
    }
  ],
  "nextCursor": null
}
GET/api/v1/users/{handle}/followingread:users

Users this user follows.

Parameters

  • handle (path, required) — The user’s handle.
  • limit (query) — Page size, 1–50 (default 20).
  • cursor (query) — Opaque cursor from a previous `nextCursor` to fetch the next page.

Example response

{
  "data": [
    {
      "id": "ck_user123",
      "name": "Ada",
      "handle": "ada",
      "image": "https://…"
    }
  ],
  "nextCursor": null
}
POST/api/v1/users/{handle}/followwrite:followsidempotent

Follow a user. Idempotent.

Parameters

  • handle (path, required) — The user’s handle.

Example response

{
  "following": true
}
DELETE/api/v1/users/{handle}/followwrite:followsidempotent

Stop following a user.

Parameters

  • handle (path, required) — The user’s handle.

Example response

{
  "following": false
}