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

# Create a tag

> Names a commit (git tag <name> <commit>). commit may be another tag, which is peeled to its commit. A name already used is refused (as git tag without -f); delete the old tag first. A folder keeps at most 200 tags.



## OpenAPI

````yaml /openapi.json post /folders/{id}/tags
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}/tags:
    post:
      tags:
        - Folders
      summary: Create a tag
      description: >-
        Names a commit (git tag <name> <commit>). commit may be another tag,
        which is peeled to its commit. A name already used is refused (as git
        tag without -f); delete the old tag first. A folder keeps at most 200
        tags.
      operationId: createFolderTag
      parameters:
        - name: id
          in: path
          required: true
          description: The folder's id (fld_...), as GET /folders lists it.
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: The tag to make.
              properties:
                name:
                  type: string
                  description: >-
                    The tag's name: 1 to 100 letters, digits and . _ - / as git
                    check-ref-format allows: no space, no .., no // or part
                    starting with ., not ending in /, . or .lock, not starting
                    with -.
                commit:
                  type: string
                  description: >-
                    A commit id or a tag name. HEAD (the newest commit) and
                    <ref>~N (N commits older) work too, as git rev-parse; past
                    the kept history is a 404.
                message:
                  type: string
                  description: An optional message, at most 500 characters.
              required:
                - name
                - commit
      responses:
        '201':
          description: The new tag.
          content:
            application/json:
              schema:
                type: object
                description: 'A tag: a name for one commit (git tag, GitHub''s /tags).'
                properties:
                  name:
                    type: string
                    description: The tag's name.
                  commit:
                    type: string
                    description: The commit it names.
                  message:
                    type: string
                    description: Its message, if given.
                  by:
                    type: string
                    description: Who made it.
                  created:
                    type: string
                    description: When it was made (ISO 8601).
                  kept:
                    type: boolean
                    description: >-
                      Whether the folder's kept history still holds its commit;
                      false: the commit aged out, and the tag no longer
                      resolves.
                  commitAt:
                    type: string
                    description: 'With kept: the commit''s time.'
                  commitMessage:
                    type: string
                    description: 'With kept: the commit''s message.'
                  html_url:
                    type: string
                    description: 'With kept: the commit on the dashboard.'
                  tree_url:
                    type: string
                    description: 'With kept: GET it for the notes at the tag.'
                  zipball_url:
                    type: string
                    description: 'With kept: GET it for the notes at the tag as a zip.'
                required:
                  - name
                  - commit
                  - kept
        '400':
          description: >-
            The body is malformed, the name breaks the rules (1 to 100 letters,
            digits and . _ - / as git check-ref-format allows: no space, no ..,
            no // or part starting with ., not ending in /, . or .lock, not
            starting with -), the name is a commit id, or the message is over
            500 characters.
          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 commit in this folder (or the tag named as commit points at
            one no longer kept), or no such folder.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NemonistError'
        '409':
          description: >-
            The name is already a tag, the folder keeps 200 tags, or it 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.