> ## 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.

# List work items

> The folder's work items (the Memory page's Goals) as GitHub issues: open first, then newest changed. state is open or closed; stateReason keeps how it closed (done or withdrawn). judgedTurns counts the turn judgments that named the item; progress is its latest (closer, same, further, blocked or done), from its own work_items update or close, else the newest judgment. q filters with the same language as the Memory page's Goals box and nemonist goal list -q: terms separated by spaces, all of which must hold: state:open|closed|done|withdrawn|duplicate|all, role:developer|reviewer|customer|none, owner:<exact owner>, progress:closer|same|further|blocked|done|none (commas mean any of), parent:<item>|none (the parts of an item, or the top items), about:none|<type>|<type>:<id> (what an item is about: none, a type of note, job, commit or tag, or one exactly, as job:10553), judged:N with >, >=, < or <=, changed: and opened: with a day (2026-11-13) or @today-Nd, -Nw, -Nm after an optional comparison, -<term> to negate, and free words that must appear in the id, content, owner or latest reason. A state: term in q replaces the state parameter. Filters read the stored items directly, so a write is seen by the next read.



## OpenAPI

````yaml /openapi.json get /folders/{id}/issues
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:
    get:
      tags:
        - Folders
      summary: List work items
      description: >-
        The folder's work items (the Memory page's Goals) as GitHub issues: open
        first, then newest changed. state is open or closed; stateReason keeps
        how it closed (done or withdrawn). judgedTurns counts the turn judgments
        that named the item; progress is its latest (closer, same, further,
        blocked or done), from its own work_items update or close, else the
        newest judgment. q filters with the same language as the Memory page's
        Goals box and nemonist goal list -q: terms separated by spaces, all of
        which must hold: state:open|closed|done|withdrawn|duplicate|all,
        role:developer|reviewer|customer|none, owner:<exact owner>,
        progress:closer|same|further|blocked|done|none (commas mean any of),
        parent:<item>|none (the parts of an item, or the top items),
        about:none|<type>|<type>:<id> (what an item is about: none, a type of
        note, job, commit or tag, or one exactly, as job:10553), judged:N with
        >, >=, < or <=, changed: and opened: with a day (2026-11-13) or
        @today-Nd, -Nw, -Nm after an optional comparison, -<term> to negate, and
        free words that must appear in the id, content, owner or latest reason.
        A state: term in q replaces the state parameter. Filters read the stored
        items directly, so a write is seen by the next read.
      operationId: listFolderIssues
      parameters:
        - name: id
          in: path
          required: true
          description: The folder's id (fld_...), as GET /folders lists it.
          schema:
            type: string
        - name: state
          in: query
          required: false
          description: open (the default), closed or all, as GitHub's issues filter.
          schema:
            type: string
        - name: q
          in: query
          required: false
          description: >-
            The filter, as role:developer progress:blocked,further judged:>2
            changed:<@today-1w -state:duplicate (URL-encoded).
          schema:
            type: string
      responses:
        '200':
          description: The work items.
          content:
            application/json:
              schema:
                type: object
                description: Work items.
                properties:
                  issues:
                    type: array
                    description: Work items, open first.
                    items:
                      type: object
                      description: A work item, shaped as a GitHub issue.
                      properties:
                        id:
                          type: string
                          description: Its id.
                        content:
                          type: string
                          description: What must be done.
                        owner:
                          type: string
                          description: Who holds it (role:<role> for a role item).
                        state:
                          type: string
                          description: open or closed.
                        stateReason:
                          type:
                            - string
                            - 'null'
                          description: >-
                            For a closed item, how it closed: done, withdrawn or
                            duplicate; null when open.
                        duplicateOf:
                          type:
                            - string
                            - 'null'
                          description: >-
                            For a duplicate close: the item the same work is
                            tracked under; null otherwise.
                        duplicates:
                          type: array
                          description: The items closed as duplicates of this one, by id.
                          items:
                            type: string
                            description: An item id.
                        parent:
                          type:
                            - string
                            - 'null'
                          description: >-
                            The item this one is part of (GitHub's parent
                            issue); null for a top item.
                        subIssues:
                          type: array
                          description: >-
                            The items that are part of this one, by id (GitHub's
                            sub-issues).
                          items:
                            type: string
                            description: An item id.
                        about:
                          type:
                            - object
                            - 'null'
                          description: >-
                            What the item is about (GitHub Projects' item
                            content), with that thing's live state read now,
                            never a copy: a job's state, exit and whether it
                            still runs; a note's about line and last commit; a
                            commit's time and message; a tag's commit and
                            whether the kept history still holds it. found is
                            false when the folder has no such thing (yet, or any
                            more). null when it names nothing.
                          properties:
                            type:
                              type: string
                              description: note, job, commit or tag.
                            id:
                              type: string
                              description: The note's path, job id, commit id or tag name.
                            found:
                              type: boolean
                              description: Whether the folder holds it now.
                            html_url:
                              type: string
                              description: Its dashboard page.
                            state:
                              type: string
                              description: 'job: the cluster''s last settled state.'
                            exit:
                              type: string
                              description: 'job: its exit, once ended.'
                            running:
                              type: boolean
                              description: 'job: not yet ended.'
                            reason:
                              type: string
                              description: 'job: why it was submitted.'
                            at:
                              type: string
                              description: 'commit, tag: the commit''s time.'
                            message:
                              type: string
                              description: 'commit, tag: the commit''s message.'
                            commit:
                              type: string
                              description: 'tag: its commit.'
                            kept:
                              type: boolean
                              description: >-
                                tag: whether the kept history still holds its
                                commit.
                            about:
                              type: string
                              description: 'note: its about line.'
                            lastCommit:
                              type: object
                              additionalProperties: {}
                              description: >-
                                note: its last commit (id, at, message,
                                html_url).
                          required:
                            - type
                            - id
                            - found
                        subIssuesSummary:
                          type: object
                          description: >-
                            The parts' rollup, computed on read (GitHub's
                            sub_issues_summary).
                          properties:
                            total:
                              type: integer
                              description: Parts.
                            completed:
                              type: integer
                              description: Parts closed in any state.
                            percentCompleted:
                              type: integer
                              description: >-
                                completed * 100 / total, floored; 0 without
                                parts.
                          required:
                            - total
                            - completed
                            - percentCompleted
                        reason:
                          type: string
                          description: The reason given with its latest change.
                        opened:
                          type: string
                          description: When it was first opened (ISO 8601).
                        changed:
                          type: string
                          description: When it last changed (ISO 8601).
                        judgedTurns:
                          type: integer
                          description: How many turn judgments named it.
                        progress:
                          type:
                            - string
                            - 'null'
                          description: >-
                            Its latest progress (closer, same, further, blocked,
                            done): from its own work_items update or close, else
                            the newest judgment naming it; null when none.
                        closures:
                          type: array
                          description: Earlier closures, kept when it was reopened.
                          items:
                            type: object
                            additionalProperties: {}
                            description: 'A closure: state, at, reason, content, reopened.'
                        role:
                          type:
                            - string
                            - 'null'
                          description: >-
                            The role that owns it (developer, reviewer or
                            customer), read from owner; null for an item no role
                            owns.
                        html_url:
                          type: string
                          description: The goal on the dashboard.
                      required:
                        - id
                        - content
                        - state
                        - judgedTurns
                  state:
                    type:
                      - string
                      - 'null'
                    description: The state parameter applied; null when q names a state.
                  q:
                    type: string
                    description: The filter applied, when one was given.
                  total:
                    type: integer
                    description: How many are listed.
                required:
                  - issues
                  - state
                  - total
        '400':
          description: >-
            state is not open, closed or all, or q has a term it cannot read
            (code BAD_QUERY: the message names the term and the valid keys or
            values), or is over 200 characters or 20 terms.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NemonistError'
        '401':
          description: Missing or invalid key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NemonistError'
        '404':
          description: No such folder under your account, or it is another member's.
          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.