Social API reference

Social API · Stories

get/v1/communities/{community_id}/actors/{actor_id}/story-trayAuth

Story tray for an actor — one entry per author with at least one unexpired or pinned story.

Includes the requester themselves and every actor they follow. Ordered by latest story timestamp. Capped at 200 entries (no cursor in v1; tray is bounded by follow-graph in normal usage). Returns `has_unviewed=true` when the requester has not recorded a `view` edge against the author's most recent story.

Path parameters

community_id*string

Community UUID.

actor_id*string

Social actor UUID (returned from POST /actors).

Response · 200 Story tray entries.

data*array

One entry per actor with live stories, on this page.

pagination*object

Always `null` — the tray is a single bounded page (≤200 entries, no cursor in v1). The key is present for envelope consistency with cursor-paginated lists (task 008 / G13).

Example

Request

GET https://social.productcraft.co/v1/communities/{community_id}/actors/{actor_id}/story-tray
Authorization: Bearer YOUR_TOKEN

Response

{
  "data": [
    {
      "actor_id": "aaaaaaaa-0000-0000-0000-000000000001",
      "actor_external_id": "alice",
      "actor_display_name": "Alice",
      "actor_avatar_url": "https://...",
      "latest_story_created_at": "2026-05-01T11:00:00.000Z",
      "story_count": 3,
      "has_unviewed": true
    }
  ],
  "pagination": {}
}