> ## Documentation Index
> Fetch the complete documentation index at: https://nemonist.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Read a work item's timeline

> One work item's story as typed, self-contained events, oldest first, as GitHub's issue timeline. Built from what is already stored: the item's opening, every close (stateReason, reason, the content it had) and reopen; the kept work_items calls (updated: the content, owner and progress set; staged: from one stage to the next; finding_added); and the judgments that named it (judged: by their item, or by the item's id as a whole word in their reason, not where the reason names it only as untouched, and a plain-word id only written as "item <id>" or quoted). Only the last 100 work_items calls a folder and the last 80 closes an item are kept: when the kept calls do not reach back to the opening, or the item holds 80 closes, complete is false and since is the time before which updates, stage moves or closes may be missing, and none is guessed (the opening and judgments are always whole).



## OpenAPI

````yaml /openapi.json get /folders/{id}/issues/{item}/timeline
openapi: 3.1.0
info:
  title: Nemonist API
  version: 1.0.0
  description: >-
    OpenRouter-compatible API with durable per-workspace memory. Point any
    OpenRouter client at https://nemonist.com/api/v1 with a Nemonist key
    (sk-nm-...). Chat completions, Responses and Messages requests from a
    workspace carrying a .nemonist/key get its memory; every other request is
    answered as OpenRouter would.
  contact:
    name: Nemonist
    url: https://nemonist.com
servers:
  - url: https://nemonist.com/api/v1
    description: Production
security:
  - apiKey: []
tags:
  - description: API key management endpoints
    name: API Keys
  - description: Analytics and usage endpoints
    name: Analytics
  - description: Anthropic Messages endpoints
    name: Anthropic Messages
  - description: BYOK endpoints
    name: BYOK
  - description: Benchmarks endpoints
    name: Benchmarks
  - description: Chat completion endpoints
    name: Chat
  - description: Credit management endpoints
    name: Credits
  - description: >-
      Public OpenRouter usage datasets. Data returned by these endpoints is
      licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/):
      reuse and republish it, including commercially, with attribution to
      OpenRouter.
    name: Datasets
  - description: Text embedding endpoints
    name: Embeddings
  - description: Endpoint information
    name: Endpoints
  - name: Folders
    description: >-
      Your memory folders, over your account's API key: read, export, upload,
      and manage keys.
  - description: Generation history endpoints
    name: Generations
  - description: Guardrails endpoints
    name: Guardrails
  - description: Images endpoints
    name: Images
  - name: Memory
    description: Nemonist's per-workspace memory.
  - name: Model runs
    description: Run models (physics and others) on inputs; one contract for every model
  - description: Model information endpoints
    name: Models
  - description: OAuth authentication endpoints
    name: OAuth
  - description: Organization endpoints
    name: Organization
  - description: Private Endpoints endpoints
    name: Private Endpoints
  - description: Provider information endpoints
    name: Providers
  - description: Rerank endpoints
    name: Rerank
  - description: OpenAI-compatible Responses API endpoints
    name: Responses
  - description: Speech-to-text endpoints
    name: STT
    x-displayName: Transcriptions
  - description: >-
      System One endpoints for models such as Jev, compatible with the TypeSafe
      SDKs. See https://openrouter.ai/docs/guides/community/typesafe-sdk.
    name: SystemOne
    x-displayName: System One
  - description: Text-to-speech endpoints
    name: TTS
    x-displayName: Speech
  - description: Video Generation endpoints
    name: Video Generation
  - description: Workspaces endpoints
    name: Workspaces
  - name: beta.responses
    description: >-
      Deprecated alias of responses. Use responses instead; scheduled for
      removal (sunset date TBD).
paths:
  /folders/{id}/issues/{item}/timeline:
    get:
      tags:
        - Folders
      summary: Read a work item's timeline
      description: >-
        One work item's story as typed, self-contained events, oldest first, as
        GitHub's issue timeline. Built from what is already stored: the item's
        opening, every close (stateReason, reason, the content it had) and
        reopen; the kept work_items calls (updated: the content, owner and
        progress set; staged: from one stage to the next; finding_added); and
        the judgments that named it (judged: by their item, or by the item's id
        as a whole word in their reason, not where the reason names it only as
        untouched, and a plain-word id only written as "item <id>" or quoted).
        Only the last 100 work_items calls a folder and the last 80 closes an
        item are kept: when the kept calls do not reach back to the opening, or
        the item holds 80 closes, complete is false and since is the time before
        which updates, stage moves or closes may be missing, and none is guessed
        (the opening and judgments are always whole).
      operationId: getFolderIssueTimeline
      parameters:
        - name: id
          in: path
          required: true
          description: The folder's id (fld_...), as GET /folders lists it.
          schema:
            type: string
        - name: item
          in: path
          required: true
          schema:
            type: string
          description: The work item's id, as GET /folders/{id}/issues lists it.
      responses:
        '200':
          description: The timeline.
          content:
            application/json:
              schema:
                type: object
                description: A work item's timeline.
                properties:
                  id:
                    type: string
                    description: The work item's id.
                  events:
                    type: array
                    description: Typed events, oldest first.
                    items:
                      type: object
                      description: One event.
                      properties:
                        event:
                          type: string
                          description: >-
                            opened, updated, staged, finding_added, closed,
                            reopened, marked_as_duplicate, parent_issue_added,
                            parent_issue_removed, sub_issue_added,
                            sub_issue_removed, connected, disconnected or
                            judged.
                        at:
                          type: string
                          description: When (ISO 8601).
                        reason:
                          type: string
                          description: Why, as the call or judgment gave it.
                        actor:
                          type: string
                          description: >-
                            The model that made the work_items call, when
                            recorded.
                        stateReason:
                          type: string
                          description: 'closed: done, withdrawn or duplicate.'
                        duplicateOf:
                          type: string
                          description: 'closed as a duplicate: the item it was folded into.'
                        duplicate:
                          type: string
                          description: >-
                            marked_as_duplicate: the item closed as a duplicate
                            of this one.
                        parent:
                          type: string
                          description: 'parent_issue_added|removed: the parent.'
                        child:
                          type: string
                          description: 'sub_issue_added|removed: the part.'
                        about:
                          type: string
                          description: >-
                            connected|disconnected: the type:id the item now
                            names, or stopped naming.
                        content:
                          type: string
                          description: >-
                            closed: the item's text then; finding_added: the
                            finding's.
                        from:
                          type:
                            - string
                            - 'null'
                          description: 'staged: the stage it left (null from none).'
                        to:
                          type: string
                          description: 'staged: the stage it entered.'
                        finding:
                          type: string
                          description: 'finding_added: the finding''s id.'
                        judgment:
                          type: string
                          description: 'judged: the judgment''s id.'
                        outcome:
                          type: string
                          description: 'judged: the outcome.'
                        progress:
                          type: string
                          description: 'judged: the progress it gave.'
                        changes:
                          type: object
                          additionalProperties: {}
                          description: >-
                            updated: the fields the update set (content, owner,
                            progress).
                      required:
                        - event
                        - at
                  complete:
                    type: boolean
                    description: >-
                      True when the kept work_items calls reach back to the
                      item's opening.
                  since:
                    type:
                      - string
                      - 'null'
                    description: When incomplete, the oldest kept call; null when complete.
                  html_url:
                    type: string
                    description: The goal on the Memory page.
                required:
                  - id
                  - events
                  - complete
                  - since
                  - html_url
        '401':
          description: Missing or invalid key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NemonistError'
        '404':
          description: No such work item, or no such folder.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NemonistError'
        '500':
          description: 'Nemonist: an internal error answered this request; retry.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NemonistError'
        '503':
          description: 'Nemonist: the account service is temporarily unavailable; retry.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NemonistError'
components:
  schemas:
    NemonistError:
      type: object
      description: An error answer.
      required:
        - error
      properties:
        error:
          type: object
          description: What went wrong.
          required:
            - message
          properties:
            code:
              type:
                - integer
                - string
              description: HTTP status or a short error code.
            type:
              type: string
              description: Error kind, such as proxy_error.
            message:
              type: string
              description: Human-readable error message.
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        A Nemonist key (sk-nm-...) as a bearer token in the Authorization
        header.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.