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

# Edit a work item by name

> A person's edit of one open work item, as GitHub's PATCH /issues/{n}: one field per call, with the reason kept on its timeline. role reassigns which role owns it (developer, reviewer or customer; whose turn it is does not change); content sets its text (at most 500 characters); progress is closer, same, further or blocked (done is the owning role's resolve, and closing is the customer's); parent makes it part of another item, "" removes it (GitHub's sub-issues: an existing item, not itself, no circle, at most 7 layers below the top item counting its own parts, at most 100 parts per parent); about names what it is about as type:id (note:<path>, job:<id>, commit:<id> or tag:<name>; "" removes it; whether it exists is the read's to say). Every broken rule is named in one refusal. The model's work_items tool has no edit.



## OpenAPI

````yaml /openapi.json patch /folders/{id}/issues/{item}
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}:
    patch:
      tags:
        - Folders
      summary: Edit a work item by name
      description: >-
        A person's edit of one open work item, as GitHub's PATCH /issues/{n}:
        one field per call, with the reason kept on its timeline. role reassigns
        which role owns it (developer, reviewer or customer; whose turn it is
        does not change); content sets its text (at most 500 characters);
        progress is closer, same, further or blocked (done is the owning role's
        resolve, and closing is the customer's); parent makes it part of another
        item, "" removes it (GitHub's sub-issues: an existing item, not itself,
        no circle, at most 7 layers below the top item counting its own parts,
        at most 100 parts per parent); about names what it is about as type:id
        (note:<path>, job:<id>, commit:<id> or tag:<name>; "" removes it;
        whether it exists is the read's to say). Every broken rule is named in
        one refusal. The model's work_items tool has no edit.
      operationId: editFolderIssue
      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.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: One field's new value.
              properties:
                field:
                  type: string
                  description: role, content, progress, parent or about.
                value:
                  type: string
                  description: The new value; for parent or about, "" removes it.
                reason:
                  type: string
                  description: Why (kept on the item's timeline).
              required:
                - field
                - value
                - reason
      responses:
        '200':
          description: The edited work item, as GET /folders/{id}/issues/{item} shows it.
          content:
            application/json:
              schema:
                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
        '400':
          description: >-
            BAD_EDIT: the body, field, value or reason breaks a rule; every
            broken one is named.
          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_ITEM: no such work item, or no such folder.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NemonistError'
        '409':
          description: >-
            CONFLICT: the item is closed or already has that value; STALE:
            another write changed it first (nothing is overwritten); BUSY: the
            folder is being merged or erased.
          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.