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

> Everything that happened to the folder in one list, newest first, as GitHub's /repos/{owner}/{repo}/activity: note commits (commit, before the parent commit and after this one), folder events from its history (rename, key_issued, key_revoked, link_approved, merge_in, merge_out, default_minted, file_deleted), tags (tag_creation) and forgets (forget: the note's path, never the forgotten text). Each item has a typed activity_type, an actor (login, kind agent or person), and before and after (null where a side has nothing). covers says what each source keeps: each note keeps its newest edits, the folder's history a year, and a forget is listed while the record of calls holds it. Every bad parameter is named in one 400.



## OpenAPI

````yaml /openapi.json get /folders/{id}/activity
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}/activity:
    get:
      tags:
        - Folders
      summary: List activity
      description: >-
        Everything that happened to the folder in one list, newest first, as
        GitHub's /repos/{owner}/{repo}/activity: note commits (commit, before
        the parent commit and after this one), folder events from its history
        (rename, key_issued, key_revoked, link_approved, merge_in, merge_out,
        default_minted, file_deleted), tags (tag_creation) and forgets (forget:
        the note's path, never the forgotten text). Each item has a typed
        activity_type, an actor (login, kind agent or person), and before and
        after (null where a side has nothing). covers says what each source
        keeps: each note keeps its newest edits, the folder's history a year,
        and a forget is listed while the record of calls holds it. Every bad
        parameter is named in one 400.
      operationId: listFolderActivity
      parameters:
        - name: id
          in: path
          required: true
          description: The folder's id (fld_...), as GET /folders lists it.
          schema:
            type: string
        - name: activity_type
          in: query
          schema:
            type: string
          description: Only this type.
        - name: actor
          in: query
          schema:
            type: string
          description: Only this actor's login.
        - name: per_page
          in: query
          schema:
            type: integer
            default: 30
            maximum: 100
          description: Items a page (1 to 100).
        - name: page
          in: query
          schema:
            type: integer
            default: 1
          description: The page, from 1.
      responses:
        '200':
          description: The activity.
          content:
            application/json:
              schema:
                type: object
                description: A page of activity.
                properties:
                  activity:
                    type: array
                    description: Items, newest first.
                    items:
                      type: object
                      description: One thing that happened.
                      properties:
                        id:
                          type: string
                          description: >-
                            Unique in the list: c:<commit>, r:<history entry>,
                            t:<tag>, f:<time>:<path>.
                        activity_type:
                          type: string
                          description: >-
                            commit, tag_creation, forget, rename, key_issued,
                            key_revoked, link_approved, merge_in, merge_out,
                            default_minted or file_deleted.
                        at:
                          type: string
                          description: ISO 8601 UTC.
                        actor:
                          type: object
                          description: Who did it.
                          properties:
                            login:
                              type: string
                              description: >-
                                The member (team memory names each edit's
                                author), else the folder's owner.
                            kind:
                              type: string
                              description: agent (an agent turn) or person.
                          required:
                            - login
                            - kind
                        before:
                          type:
                            - object
                            - 'null'
                          description: >-
                            The side before: the parent commit, the old name,
                            the revoked key, the merged-in folder, the deleted
                            upload's path and bytes, or the forgotten note's
                            path.
                        after:
                          type:
                            - object
                            - 'null'
                          description: >-
                            The side after: the commit, the new name (hidden
                            true when a detected name is hidden), the new key,
                            the folder merged into, or the tag and its commit.
                        message:
                          type: string
                          description: 'commit: its message.'
                        paths:
                          type: array
                          description: 'commit: the notes it changed.'
                          items:
                            type: string
                            description: A note path.
                        html_url:
                          type: string
                          description: 'commit: the dashboard''s commit page.'
                      required:
                        - id
                        - activity_type
                        - at
                        - actor
                        - before
                        - after
                  total:
                    type: integer
                    description: Items the filters keep.
                  filters:
                    type: object
                    description: The filters applied.
                    properties: {}
                  pageInfo:
                    type: object
                    description: Paging.
                    properties:
                      page:
                        type: integer
                        description: This page.
                      per_page:
                        type: integer
                        description: Page size.
                      hasNextPage:
                        type: boolean
                        description: Whether a later page has items.
                  covers:
                    type: object
                    description: What each source keeps.
                    properties: {}
                required:
                  - activity
                  - total
                  - pageInfo
                  - covers
        '400':
          description: >-
            activity_type is not one listed, per_page is not 1 to 100, or page
            is under 1 (all named in one message).
          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.