Skip to content

Posts

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

GET/api/v1/postsread:posts

Your recent posts, newest first.

Parameters

  • 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
      }
    }
  ],
  "nextCursor": "2026-06-20T10:00:00.000Z"
}
POST/api/v1/postswrite:postsidempotent

Create a post on your account. Awards XP and progresses quests exactly like the in-app composer.

Body

  • content (string) — 1–280 characters. Optional if at least one `media_ids` entry is supplied.
  • media_ids (string[]) — Up to 4 media ids from POST /api/v1/images.
  • audience (string) — `PUBLIC` (default), `FOLLOWERS`, or `PRIVATE`.

Example request

{
  "content": "Posted via the API!",
  "audience": "PUBLIC"
}

Example response (201)

{
  "id": "ck_post123",
  "content": "Posted via the API!",
  "audience": "PUBLIC",
  "createdAt": "2026-06-30T10:00:00.000Z"
}
GET/api/v1/posts/{id}read:posts

Fetch a single post by id. Returns public posts and your own posts; otherwise 404.

Parameters

  • id (path, required) — The post id.

Example response

{
  "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://…"
  }
}
DELETE/api/v1/posts/{id}write:postsidempotent

Soft-delete one of your own posts. Returns 204 on success.

Parameters

  • id (path, required) — The post id.