Skip to content
Sesharo Docs

List Narratives

GET
/users/{user_id}/narratives
curl --request GET \
  --url 'https://example.com/users/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/narratives?limit=12'

The user’s stored narratives, most recent week first.

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
user_id
required
User Id
string format: uuid

Query Parameters

Section titled “Query Parameters”
limit
Limit
integer
default: 12 >= 1 <= 52

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
Response List Narratives Users User Id Narratives Get
Array<object>
NarrativeRead

A stored weekly narrative. narrative_text is the LLM prose; the provider/model/token fields are provenance for cost visibility and auditing which backend produced it.

object
created_at
required
Created At
string format: date-time
id
required
Id
string format: uuid
input_tokens
required
Any of:
integer
model_used
required
Any of:
string
narrative_text
required
Narrative Text
string
output_tokens
required
Any of:
integer
period_end
required
Period End
string format: date
period_start
required
Period Start
string format: date
period_type
required
Period Type
string
provider
required
Any of:
string
updated_at
required
Updated At
string format: date-time
Examplegenerated
[
  {
    "created_at": "2026-04-15T12:00:00Z",
    "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "input_tokens": 1,
    "model_used": "example",
    "narrative_text": "example",
    "output_tokens": 1,
    "period_end": "2026-04-15",
    "period_start": "2026-04-15",
    "period_type": "example",
    "provider": "example",
    "updated_at": "2026-04-15T12:00:00Z"
  }
]

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}