# nemonist > Memory and learning for your coding agent, behind one OpenRouter-compatible URL. - [What is nemonist](https://nemonist.com/docs/index.md): A drop-in endpoint for the models you already use, with a memory for each workspace that learns from every turn. - [Quickstart](https://nemonist.com/docs/quickstart.md): Point the agent you already use at nemonist. One URL and one key; your agent starts remembering and learning on its next request. - [Models and pricing](https://nemonist.com/docs/models-and-pricing.md): Hundreds of models behind one key, at provider prices. - [Troubleshooting](https://nemonist.com/docs/troubleshooting.md): Fixes for the common setup problems. - [Migrating from OpenRouter](https://nemonist.com/docs/migrating-from-openrouter.md): Change the base URL and the key; keep your requests. - [Memory](https://nemonist.com/docs/concepts/memory.md): How your agent remembers and learns, one workspace at a time, and what you can read, rename or erase. - [API keys](https://nemonist.com/docs/concepts/api-keys.md): Create, limit, rotate and revoke the keys your clients use. - [Workspaces](https://nemonist.com/docs/concepts/workspaces.md): Group keys with their own budgets, guardrails, Router key and provider order. - [Credits and billing](https://nemonist.com/docs/concepts/credits.md): Provider prices on every token. Start free; a fee is taken only when you buy credits. - [Bring your own key](https://nemonist.com/docs/concepts/byok.md): Bill requests to your own Router key or provider accounts. - [Slack](https://nemonist.com/docs/concepts/slack.md): Connect a Slack channel to a project, so your team can ask it questions and leave it work. - [Server tools](https://nemonist.com/docs/concepts/server-tools.md): Web search, web fetch and the current date, run by nemonist so your app does not have to. - [Guardrails](https://nemonist.com/docs/concepts/guardrails.md): Spending limits, model and provider restrictions, prompt-injection and sensitive-info policies for a group of keys. - [Privacy](https://nemonist.com/docs/concepts/privacy.md): Account-wide controls over where your prompts go and what is recorded. - [Errors and retries](https://nemonist.com/docs/concepts/errors.md): What each status means and when to retry. - [Organizations and roles](https://nemonist.com/docs/enterprise/organizations.md): Share credits and keys with a team, with roles and per-person memory. - [Single sign-on](https://nemonist.com/docs/enterprise/sso.md): Sign in through Okta, Entra ID, Google Workspace or any SAML 2.0 provider. - [SCIM provisioning](https://nemonist.com/docs/enterprise/scim.md): Let your identity provider add and remove people. - [Key safety and IP allowlist](https://nemonist.com/docs/enterprise/security.md): Find at-risk keys and restrict where keys work from. - [Workload identity](https://nemonist.com/docs/enterprise/workload-identity.md): CI jobs and cloud workloads get a one-hour key from their own identity token, so no long-lived key is stored in CI. - [Audit log](https://nemonist.com/docs/enterprise/audit-log.md): Who changed keys, members, workspaces, guardrails, billing, privacy and team notes. - [Cursor](https://nemonist.com/docs/clients/cursor.md): Use nemonist from Cursor's chat and agent with your nemonist key. - [Claude Code](https://nemonist.com/docs/clients/claude-code.md): Run Claude Code through nemonist with any model. - [Claude Desktop](https://nemonist.com/docs/clients/claude-desktop.md): Use Claude Desktop, Cowork and Claude Code inside it, through nemonist. - [Codex](https://nemonist.com/docs/clients/codex.md): Add nemonist as a model provider in the Codex CLI. - [OpenCode](https://nemonist.com/docs/clients/opencode.md): Add nemonist as a provider in OpenCode. - [Junie](https://nemonist.com/docs/clients/junie.md): Use JetBrains Junie CLI with nemonist through a custom model profile. - [OpenClaw](https://nemonist.com/docs/clients/openclaw.md): Add nemonist as a model provider in OpenClaw. - [Hermes](https://nemonist.com/docs/clients/hermes.md): Use Hermes Agent with nemonist through its OpenRouter provider. - [SDKs](https://nemonist.com/docs/clients/sdks.md): Use the official OpenAI and Anthropic SDKs, or any OpenAI-compatible client, with a new base URL. - [Overview](https://nemonist.com/docs/api-reference/overview.md): The nemonist API: OpenRouter-compatible, at https://nemonist.com/api/v1. - [Output items](https://nemonist.com/docs/api-reference/output-items.md) - [Get user activity grouped by endpoint](https://nemonist.com/docs/api-reference/analytics/get-user-activity-grouped-by-endpoint.md): Returns user activity data grouped by endpoint for the last 30 (completed) UTC days. Pass `workspace_id` to scope the response to a single workspace. Pass `group_by=workspace` to split each row per workspace and include `workspace_id` on every item; by default rows are aggregated across workspaces a… - [Create speech](https://nemonist.com/docs/api-reference/tts/create-speech.md): Synthesizes audio from the input text. Returns a raw audio bytestream in the requested format (e.g. mp3, pcm, wav). - [Create transcription](https://nemonist.com/docs/api-reference/stt/create-transcription.md): Transcribes audio into text. Accepts base64-encoded audio input as JSON, an OpenAI-style multipart/form-data file upload, or a URL the provider downloads directly, and returns the transcribed text. - [Exchange authorization code for API key](https://nemonist.com/docs/api-reference/oauth/exchange-authorization-code-for-api-key.md): Exchange an authorization code from the PKCE flow for a user-controlled API key - [List Benchmarks](https://nemonist.com/docs/api-reference/benchmarks/list-benchmarks.md): Unified benchmark endpoint that aggregates scores from multiple benchmark sources (Artificial Analysis, Design Arena, and OpenRouter's own tau-bench, GPQA, and web-search evals). Filter by source to reproduce the exact shapes from the legacy per-source endpoints, or use task_type to find models suit… - [List BYOK provider credentials](https://nemonist.com/docs/api-reference/byok/list-byok-provider-credentials.md): List the bring-your-own-key (BYOK) provider credentials for the authenticated entity's default workspace. Use the `workspace_id` query parameter to scope the result to a different workspace, or the `provider` query parameter to filter by upstream provider. [Management key](/docs/guides/overview/auth… - [Create a BYOK provider credential](https://nemonist.com/docs/api-reference/byok/create-a-byok-provider-credential.md): Create a new bring-your-own-key (BYOK) provider credential. The raw key is encrypted at rest and never returned in API responses. When `workspace_id` is omitted, the credential is created in the default workspace; if that default has been deleted, the request returns a 400 and you must pass `workspa… - [Get a BYOK provider credential](https://nemonist.com/docs/api-reference/byok/get-a-byok-provider-credential.md): Get a single bring-your-own-key (BYOK) provider credential by its `id`. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [Delete a BYOK provider credential](https://nemonist.com/docs/api-reference/byok/delete-a-byok-provider-credential.md): Delete (soft-delete) a bring-your-own-key (BYOK) provider credential by its `id`. The encrypted key material is wiped and the record is marked as deleted. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [Update a BYOK provider credential](https://nemonist.com/docs/api-reference/byok/update-a-byok-provider-credential.md): Update an existing bring-your-own-key (BYOK) provider credential by its `id`. Include the `key` field to rotate the raw provider API key in-place (the previous key material is overwritten). Use `allowed_api_key_hashes` to restrict the credential to specific OpenRouter API keys (`null` clears the res… - [Create a chat completion](https://nemonist.com/docs/api-reference/chat/create-a-chat-completion.md): Sends a request for a model response for the given chat conversation. Supports both streaming and non-streaming modes. - [Get remaining credits](https://nemonist.com/docs/api-reference/credits/get-remaining-credits.md): Get total credits purchased and used for the authenticated user. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [Top apps by token usage](https://nemonist.com/docs/api-reference/datasets/top-apps-by-token-usage.md): Returns the top public apps on OpenRouter ranked by token usage inside the requested date window, matching the public apps marketplace on openrouter.ai/apps. Token totals are `prompt_tokens + completion_tokens`; hidden and private apps are excluded and traffic from related app aliases is merged into… - [Daily token totals for top 50 models](https://nemonist.com/docs/api-reference/datasets/daily-token-totals-for-top-50-models.md): Returns the top 50 public models per day by total token usage on OpenRouter, plus a single aggregated `other` row per day that sums every model outside that top 50. Token totals are `prompt_tokens + completion_tokens`, matching the public rankings chart on openrouter.ai/rankings. - [Submit an embedding request](https://nemonist.com/docs/api-reference/embeddings/submit-an-embedding-request.md): Submits an embedding request to the embeddings router - [List all embeddings models](https://nemonist.com/docs/api-reference/embeddings/list-all-embeddings-models.md): Returns a list of all available embeddings models and their properties - [Preview the impact of ZDR on the available endpoints](https://nemonist.com/docs/api-reference/endpoints/preview-the-impact-of-zdr-on-the-available-endpoints.md): Lists the model endpoints whose providers keep no prompt or completion data (zero data retention). - [List all endpoints for a model](https://nemonist.com/docs/api-reference/endpoints/list-all-endpoints-for-a-model.md): Lists the provider endpoints serving one model, with each one's pricing, limits, latency and uptime. - [Get request & usage metadata for a generation](https://nemonist.com/docs/api-reference/generations/get-request-&-usage-metadata-for-a-generation.md): One request's metadata by its generation id (the X-Generation-Id response header): model, provider, tokens, cost and timing. - [List guardrails](https://nemonist.com/docs/api-reference/guardrails/list-guardrails.md): List all guardrails for the authenticated user. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [Create a guardrail](https://nemonist.com/docs/api-reference/guardrails/create-a-guardrail.md): Create a new guardrail for the authenticated user. A newly created guardrail enforces nothing until it is assigned to API keys or organization members; `workspace_id` places the guardrail in a workspace but does not apply it to that workspace's traffic. To restrict all traffic in a workspace, update… - [Get a guardrail](https://nemonist.com/docs/api-reference/guardrails/get-a-guardrail.md): Get a single guardrail by ID. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [Delete a guardrail](https://nemonist.com/docs/api-reference/guardrails/delete-a-guardrail.md): Delete an existing guardrail. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [Update a guardrail](https://nemonist.com/docs/api-reference/guardrails/update-a-guardrail.md): Update an existing guardrail, or materialize an unconfigured workspace default guardrail. Collection fields use replace semantics: send the full desired set on every update. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [List key assignments for a guardrail](https://nemonist.com/docs/api-reference/guardrails/list-key-assignments-for-a-guardrail.md): List all API key assignments for a specific guardrail. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [Bulk assign keys to a guardrail](https://nemonist.com/docs/api-reference/guardrails/bulk-assign-keys-to-a-guardrail.md): Assign multiple API keys to a specific guardrail. A key may hold at most one guardrail; assigning replaces any existing assignment. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [Bulk unassign keys from a guardrail](https://nemonist.com/docs/api-reference/guardrails/bulk-unassign-keys-from-a-guardrail.md): Unassign multiple API keys from a specific guardrail. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [List all key assignments](https://nemonist.com/docs/api-reference/guardrails/list-all-key-assignments.md): List all API key guardrail assignments for the authenticated user. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [Generate an image](https://nemonist.com/docs/api-reference/images/generate-an-image.md): Generates an image from a text prompt via the image generation router - [List image generation models](https://nemonist.com/docs/api-reference/images/list-image-generation-models.md): Lists every image generation model with its top-level supported-parameter superset and a URL to its full per-endpoint records. - [List endpoints for an image model](https://nemonist.com/docs/api-reference/images/list-endpoints-for-an-image-model.md): Returns the full per-endpoint records for an image model: each endpoint's definitive supported parameters, pricing, and passthrough allowlist. - [Get current API key](https://nemonist.com/docs/api-reference/api-keys/get-current-api-key.md): Get information on the API key associated with the current authentication session - [List API keys](https://nemonist.com/docs/api-reference/api-keys/list-api-keys.md): List all API keys for the authenticated user. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [Create a new API key](https://nemonist.com/docs/api-reference/api-keys/create-a-new-api-key.md): Create a new API key for the authenticated user. The plaintext `key` is returned only in this response. Treat it as a write-only, sensitive value; it cannot be retrieved later. Authenticate with a [management key](/docs/guides/overview/auth/management-api-keys). The optional `external` object associ… - [Get a single API key](https://nemonist.com/docs/api-reference/api-keys/get-a-single-api-key.md): Get a single API key by hash. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [Delete an API key](https://nemonist.com/docs/api-reference/api-keys/delete-an-api-key.md): Delete an existing API key. Authenticate with a [management key](/docs/guides/overview/auth/management-api-keys). - [Update an API key](https://nemonist.com/docs/api-reference/api-keys/update-an-api-key.md): Update an existing API key. Authenticate with a [management key](/docs/guides/overview/auth/management-api-keys). - [Create a message](https://nemonist.com/docs/api-reference/anthropic-messages/create-a-message.md): Creates a message using the Anthropic Messages API format. Supports text, images, PDFs, tools, and extended thinking. - [Get a model by its slug](https://nemonist.com/docs/api-reference/models/get-a-model-by-its-slug.md): Returns full details for a single model identified by its author and slug (e.g. openai/gpt-4). Supports variant suffixes (e.g. openai/gpt-4:free) and resolves known slug aliases. - [List all models and their properties](https://nemonist.com/docs/api-reference/models/list-all-models-and-their-properties.md): Lists every model available, with its context length, pricing, modalities and supported parameters. - [Get total count of available models](https://nemonist.com/docs/api-reference/models/get-total-count-of-available-models.md): How many models are available. - [List models filtered by user provider preferences, privacy settings, and guardrails](https://nemonist.com/docs/api-reference/models/list-models-filtered-by-user-provider-preferences-privacy-settings-and-guardrails.md): List models filtered by user provider preferences, [privacy settings](https://openrouter.ai/docs/guides/privacy/provider-logging), and [guardrails](https://openrouter.ai/docs/guides/features/guardrails). Returns text-output models by default; pass `output_modalities` (a comma-separated list of `text… - [List organization members](https://nemonist.com/docs/api-reference/organization/list-organization-members.md): List all members of the organization associated with the authenticated management key. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [List private endpoints](https://nemonist.com/docs/api-reference/private-endpoints/list-private-endpoints.md): Lists the account's custom endpoints, drafts included. Management key required. - [Create a private endpoint](https://nemonist.com/docs/api-reference/private-endpoints/create-a-private-endpoint.md): Creates a custom endpoint as a draft. Drafts are not routed: validate one with POST /private-endpoints/{id}/validate, then activate it. Pass activate to do all three in one call; if validation fails the draft is kept and answered with 422 and its checks. Send an Idempotency-Key header to make retrie… - [Get a private endpoint](https://nemonist.com/docs/api-reference/private-endpoints/get-a-private-endpoint.md): One custom endpoint with its last validation. Management key required. - [Delete a private endpoint](https://nemonist.com/docs/api-reference/private-endpoints/delete-a-private-endpoint.md): Deletes a custom endpoint and stops routing to it. draft_only=true refuses (409) once it was activated. Management key required. - [Update a private endpoint](https://nemonist.com/docs/api-reference/private-endpoints/update-a-private-endpoint.md): Changes a draft; the answer is the whole endpoint. A non-draft answers 409 not_draft: disable or delete and re-create instead. Management key required. - [Activate a validated private endpoint](https://nemonist.com/docs/api-reference/private-endpoints/activate-a-validated-private-endpoint.md): Routes a validated draft. 409 not_validated when it never passed validation, validation_stale when it changed since. Management key required. - [Disable a private endpoint](https://nemonist.com/docs/api-reference/private-endpoints/disable-a-private-endpoint.md): Stops routing to an active endpoint without deleting it. Management key required. - [Enable a private endpoint](https://nemonist.com/docs/api-reference/private-endpoints/enable-a-private-endpoint.md): Resumes routing to a disabled endpoint. Management key required. - [Validate a draft private endpoint](https://nemonist.com/docs/api-reference/private-endpoints/validate-a-draft-private-endpoint.md): Runs live calls to the server with its key (base URL, auth, model list, chat, usage, stream, and each declared format). Failed checks answer 200 with passed false. Management key required. - [List all providers](https://nemonist.com/docs/api-reference/providers/list-all-providers.md): Lists the providers models are routed to, with their policy links and headquarters. - [Submit a rerank request](https://nemonist.com/docs/api-reference/rerank/submit-a-rerank-request.md): Submits a rerank request to the rerank router - [Create a response](https://nemonist.com/docs/api-reference/responses/create-a-response.md): Creates a streaming or non-streaming response using OpenResponses API format - [Submit a System One request](https://nemonist.com/docs/api-reference/systemone/submit-a-system-one-request.md): Sends state and typed questions to a System One model such as Jev and returns its answers. Compatible with the TypeSafe SDKs. Bare System One model IDs such as `jev-1.13` and `jev-latest` are mapped onto the `typesafe/` namespace. - [List all video generation models](https://nemonist.com/docs/api-reference/video-generation/list-all-video-generation-models.md): Returns a list of all available video generation models and their properties - [List workspaces](https://nemonist.com/docs/api-reference/workspaces/list-workspaces.md): List all workspaces for the authenticated user. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [Create a workspace](https://nemonist.com/docs/api-reference/workspaces/create-a-workspace.md): Create a new workspace for the authenticated user. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [Get a workspace](https://nemonist.com/docs/api-reference/workspaces/get-a-workspace.md): Get a single workspace by ID or slug. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [Delete a workspace](https://nemonist.com/docs/api-reference/workspaces/delete-a-workspace.md): Delete an existing workspace. Workspaces with active API keys cannot be deleted; remove the keys first. Deleting the default workspace requires confirm_default_workspace_deletion=true. Deleting any workspace permanently deletes its budgets and guardrails and disables its classifiers and broadcast de… - [Update a workspace](https://nemonist.com/docs/api-reference/workspaces/update-a-workspace.md): Update an existing workspace by ID or slug. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [List workspace members](https://nemonist.com/docs/api-reference/workspaces/list-workspace-members.md): List all members of a workspace. Returns paginated results. For the default workspace, returns all organization members (implicit membership). [Management key](/docs/guides/overview/auth/management-api-keys) required. - [Bulk add members to a workspace](https://nemonist.com/docs/api-reference/workspaces/bulk-add-members-to-a-workspace.md): Add multiple organization members to a workspace. Members are assigned the same role they hold in the organization. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [Bulk remove members from a workspace](https://nemonist.com/docs/api-reference/workspaces/bulk-remove-members-from-a-workspace.md): Remove multiple members from a workspace. Members with active API keys in the workspace cannot be removed. SCIM-managed members cannot be removed; changes must be made in your identity provider. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [List workspace budgets](https://nemonist.com/docs/api-reference/workspaces/list-workspace-budgets.md): List all budgets configured for a workspace. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [Get a workspace budget](https://nemonist.com/docs/api-reference/workspaces/get-a-workspace-budget.md): Retrieve the budget for a given interval. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [Create or update a workspace budget](https://nemonist.com/docs/api-reference/workspaces/create-or-update-a-workspace-budget.md): Create or update the budget for a given interval. Budget limits must strictly decrease as the interval narrows (lifetime > monthly > weekly > daily). The optional `include_byok_in_budgets` flag is a workspace-wide setting: when provided it applies to every budget interval for the workspace, not just… - [Delete a workspace budget](https://nemonist.com/docs/api-reference/workspaces/delete-a-workspace-budget.md): Remove the budget for a given interval. [Management key](/docs/guides/overview/auth/management-api-keys) required. - [Erase all memory](https://nemonist.com/docs/api-reference/memory/erase-all-memory.md): Erases every workspace memory this key's account holds and the request records kept for it. It cannot be undone. - [Read a workspace's memory](https://nemonist.com/docs/api-reference/memory/read-a-workspaces-memory.md): One workspace's memory: each file's text and summary, and the latest memory reads and edits with their reason, model and time. The workspace is named by its .nemonist/key, sent in a header so it never lands in access logs. - [List a folder's inbox by its key](https://nemonist.com/docs/api-reference/memory/list-a-folders-inbox-by-its-key.md): The folder's inbox, named by its .nemonist/key: each message with its state and the reply it got. - [Send a message to a folder](https://nemonist.com/docs/api-reference/memory/send-a-message-to-a-folder.md): Queues a message for the folder's next turn. The agent sees it in that turn, and the turn's reply is kept on the message (GET /inbox). - [Get a workspace's memory graph](https://nemonist.com/docs/api-reference/memory/get-a-workspaces-memory-graph.md): The memory graph of the folder named by its .nemonist/key: notes, turns, judgments, work items and jobs, and the recorded relations between them. - [List your folders](https://nemonist.com/docs/api-reference/folders/list-your-folders.md): Your folders, most recently used first: id, name, last use and how much each holds. In an organization each member sees only their own. - [Get a folder](https://nemonist.com/docs/api-reference/folders/get-a-folder.md): One folder: its name, every key that reaches it, its memory index, work items, recent judgments, nightly sleep and last 30 days of charges. - [Erase a folder](https://nemonist.com/docs/api-reference/folders/erase-a-folder.md): Erases the folder: its notes, work items, judgments and recorded requests. It cannot be undone. - [Rename a folder](https://nemonist.com/docs/api-reference/folders/rename-a-folder.md): Sets the folder's name; an empty name removes it. The folder's history records the change. - [Read a note](https://nemonist.com/docs/api-reference/folders/read-a-note.md): One note of the folder: its text and about line. With at, the note as that commit left it (git show :), rebuilt from its kept edits; 409 when they cannot rebuild it, never a guess. - [List recorded requests](https://nemonist.com/docs/api-reference/folders/list-recorded-requests.md): The requests the folder served, newest first, 50 at a time, without their bodies. - [Read a recorded request](https://nemonist.com/docs/api-reference/folders/read-a-recorded-request.md): One recorded request exactly as the client sent it, read-only: its first 1 MB, with truncated set when there is more. - [Export a folder](https://nemonist.com/docs/api-reference/folders/export-a-folder.md): Every note, work item and judgment of the folder as JSON Lines, one object per line with its kind (folder, note, item or judgment). Every kept judgment is included. With ref, the folder as a commit left it: each note's text then (a version the kept history cannot rebuild is a note line with rebuilt… - [Get a folder's memory graph](https://nemonist.com/docs/api-reference/folders/get-a-folders-memory-graph.md): The folder's memory graph: notes, turns, judgments, work items and jobs, and the recorded relations between them. - [Turn nightly sleep on or off](https://nemonist.com/docs/api-reference/folders/turn-nightly-sleep-on-or-off.md): Turns the folder's nightly sleep on or off. Each night it runs, it proposes one open work item (sleep) for your agent: lessons not yet written down, files over budget and notes unread for 90 days. It never edits notes. - [Issue a key](https://nemonist.com/docs/api-reference/folders/issue-a-key.md): Issues a new key for the folder, shown once. Put it in .nemonist/key at the root of a project to use this folder there. - [Revoke a key](https://nemonist.com/docs/api-reference/folders/revoke-a-key.md): Revokes one key: requests carrying it are refused from then on. The folder's history records it. - [Merge into another folder](https://nemonist.com/docs/api-reference/folders/merge-into-another-folder.md): Moves this folder's notes, items and judgments into another of your folders; this id then redirects there. It is final. - [List uploaded files](https://nemonist.com/docs/api-reference/folders/list-uploaded-files.md): The files uploaded to the folder, which its jobs read with nm-file PATH. - [Download an uploaded file](https://nemonist.com/docs/api-reference/folders/download-an-uploaded-file.md): One uploaded file's bytes; a large file answers 303 with a signed download link instead. - [Delete an uploaded file](https://nemonist.com/docs/api-reference/folders/delete-an-uploaded-file.md): Removes one uploaded file for good: every stored version and any unfinished upload of it. The folder's history records who deleted it, when and its size. It cannot be undone. - [Get an upload URL](https://nemonist.com/docs/api-reference/folders/get-an-upload-url.md): A signed URL to PUT one new file into the folder, valid for an hour. Uploads never overwrite a file. - [Start or continue a multipart upload](https://nemonist.com/docs/api-reference/folders/start-or-continue-a-multipart-upload.md): For a large file: send path and bytes to start, or upload (the token) to get URLs for the parts still to send. - [Complete a multipart upload](https://nemonist.com/docs/api-reference/folders/complete-a-multipart-upload.md): Joins the uploaded parts into the file once every part is in. - [List a folder's jobs](https://nemonist.com/docs/api-reference/folders/list-a-folders-jobs.md): The folder's compute jobs, newest first: status and conclusion, queue, time limit, Slurm state, exit, cost, and each ended job's copied outputs. - [Download a job output](https://nemonist.com/docs/api-reference/folders/download-a-job-output.md): One copied output of an ended job; a large one answers 303 with a signed download link. - [List a folder's inbox](https://nemonist.com/docs/api-reference/folders/list-a-folders-inbox.md): Messages sent to the folder from outside its chats, newest first, with their state and the reply each got. - [Get a folder's tool use](https://nemonist.com/docs/api-reference/folders/get-a-folders-tool-use.md): How often the agent called each server-side tool in this folder, its errors, and the 20 latest error messages. - [List commits](https://nemonist.com/docs/api-reference/folders/list-commits.md): The folder's commits, as GitHub's commit list: one per agent turn (every note edit the turn made; a turn whose edits another commit interrupts is several commits, the first with the turn id and each later one a fresh 16-hex id, so history stays one line and every short id differs), newest first, gro… - [Get a commit](https://nemonist.com/docs/api-reference/folders/get-a-commit.md): One commit, as GitHub's commit page: each note it changed with its status and the text the edit replaced and put in, its parent commit, and its checks (the judgments recorded for that turn). - [List notes at a commit](https://nemonist.com/docs/api-reference/folders/list-notes-at-a-commit.md): Every note as a commit left the folder, as git ls-tree -r and GitHub's Browse files; without at, today. Each entry is the note's newest kept edit at or before that commit: its size then and the last commit that touched it. Notes made later, and notes deleted by then, are left out. A version… - [Download notes as a zip](https://nemonist.com/docs/api-reference/folders/download-notes-as-a-zip.md): The folder's notes today as files in a zip, as GitHub's zipball: one top folder named -, each note at its path. Notes that cannot be written exactly are never guessed: NOT_INCLUDED.txt in the zip names each with why. - [Download notes at a commit as a zip](https://nemonist.com/docs/api-reference/folders/download-notes-at-a-commit-as-a-zip.md): The notes as a commit left the folder, as files in a zip (GitHub's zipball/{ref}, git archive ): the same notes GET /folders/{id}/tree?at= lists, each with the text GET /folders/{id}/memory/{path}?at= returns, under one top folder -. Notes made later o… - [List tags](https://nemonist.com/docs/api-reference/folders/list-tags.md): The folder's tags, newest first (git tag --sort=-creatordate, GitHub's /tags): each names one commit and works wherever a commit id does (commits/{commit}, tree?at=, memory/{path}?at=, zipball/{commit}, export?ref=). A full commit id wins over a tag of the same name. A tag whose commit has aged out… - [Create a tag](https://nemonist.com/docs/api-reference/folders/create-a-tag.md): Names a commit (git tag ). 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. - [Delete a tag](https://nemonist.com/docs/api-reference/folders/delete-a-tag.md): Removes the tag (git tag -d). The commit and its notes stay as they are. - [Get contributors](https://nemonist.com/docs/api-reference/folders/get-contributors.md): Who changed the folder's notes, week by week (GitHub's /stats/contributors, Insights > Contributors), from the kept history. One commit is one agent turn; its author is the member named on its edits (team memory), else the folder's owner (login null). kind is agent for an agent turn, person for an e… - [Get commit activity](https://nemonist.com/docs/api-reference/folders/get-commit-activity.md): Commits per week over the last 52 weeks, oldest first, each split by day Sunday to Saturday (UTC), as GitHub's /stats/commit_activity, from the kept history (covers says what was counted). - [Blame a note](https://nemonist.com/docs/api-reference/folders/blame-a-note.md): Each line of a note beside the commit that last changed it, as GitHub's blame (GraphQL blame(path) ranges, the Memory page's Blame tab): adjacent lines with the same commit form one range. Worked out from each edit's kept replaced and added text, never guessed: when the kept history cannot establish… - [List work items](https://nemonist.com/docs/api-reference/folders/list-work-items.md): 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… - [Read a work item](https://nemonist.com/docs/api-reference/folders/read-a-work-item.md): One work item, with timeline: the turn judgments that named it, newest first. - [Edit a work item by name](https://nemonist.com/docs/api-reference/folders/edit-a-work-item-by-name.md): 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, s… - [Compare two commits](https://nemonist.com/docs/api-reference/folders/compare-two-commits.md): What changed across the whole folder between two commits, as GitHub's /compare/{base}...{head} and git diff a b. basehead is ... or ..; each end is a commit id, a tag or a unique prefix of 4 or more characters, and an empty head (or HEAD) means today. History is one line, so… - [Read a work item's timeline](https://nemonist.com/docs/api-reference/folders/read-a-work-items-timeline.md): 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: f… - [List activity](https://nemonist.com/docs/api-reference/folders/list-activity.md): 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_… - [Revert a commit](https://nemonist.com/docs/api-reference/folders/revert-a-commit.md): A new commit that undoes one commit's note edits, as git revert: each note it changed gets the inverse edit (lines put back, a note it created deleted, a note it deleted restored, a rename renamed back), all in one write, with the message Revert "". History is never rewritten: the reverted… - [Get goal insights](https://nemonist.com/docs/api-reference/folders/get-goal-insights.md): The goals' burn up, as GitHub Projects' built-in Burn up chart: for each UTC day of the period, how many goals were open and how many closed at that day's end (today: up to now), and today's counts grouped by state, role and progress. Computed on read from each goal's opened time, its close and its… - [List saved goal views](https://nemonist.com/docs/api-reference/folders/list-saved-goal-views.md): Every saved view of the folder's goals, by number, as GitHub Projects' views; view 1 is the default, Open and recent, until one is saved as 1. Only the owner reads and writes them; an agent has no tool for views. - [Save a goal view](https://nemonist.com/docs/api-reference/folders/save-a-goal-view.md): Saves a new view with the next number. A folder keeps at most 50 views. - [Get a goal view](https://nemonist.com/docs/api-reference/folders/get-a-goal-view.md): One view. - [Delete a goal view](https://nemonist.com/docs/api-reference/folders/delete-a-goal-view.md): The view goes; the goals are untouched. Deleting view 1 brings the default back. - [Edit a goal view](https://nemonist.com/docs/api-reference/folders/edit-a-goal-view.md): The fields given replace the saved ones; the merged view is checked whole (a group change re-checks its WIP columns). Saving view 1 stores it in place of the default. - [List a view's goals](https://nemonist.com/docs/api-reference/folders/list-a-views-goals.md): The goals the view's filter keeps (closed ones included unless the filter hides them), in its sort, with each WIP limit's count. - [List uploaded files](https://nemonist.com/docs/api-reference/model-runs/list-uploaded-files.md): Files uploaded to the folder, for runs to name. - [Start a file upload](https://nemonist.com/docs/api-reference/model-runs/start-a-file-upload.md): Returns a signed nemonist.com upload URL, good for an hour: PUT the bytes there (curl given), up to 5 GB. A path is never overwritten. - [List models](https://nemonist.com/docs/api-reference/model-runs/list-models.md): Every model you can run: its id, task, and the task's input schema and result. - [List runs](https://nemonist.com/docs/api-reference/model-runs/list-runs.md): The folder's runs, newest first. - [Start a run](https://nemonist.com/docs/api-reference/model-runs/start-a-run.md): Starts a model on an input and returns at once with a polling_url. Inputs are checked against the model's task schema before anything is charged; a refusal names the field. - [Poll a run](https://nemonist.com/docs/api-reference/model-runs/poll-a-run.md): The run's status; once completed, result holds the model's result. - [Cancel a run](https://nemonist.com/docs/api-reference/model-runs/cancel-a-run.md): Stops the run; only the time run is charged. - [Download a run output](https://nemonist.com/docs/api-reference/model-runs/download-a-run-output.md): One output file (result.json, fields.tar.gz, log.txt...); large files answer 303 to a signed link. ## OpenAPI Specs - [openapi](/docs/openapi.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.