> ## Documentation Index > Fetch the complete documentation index at: https://docs.eversince.ai/llms.txt > Use this file to discover all available pages before exploring further. # save document > Save or rewrite a library document: markdown or plain text up to 200k bytes, with library items woven in as [Title](item:REF) inline or ![Caption](item:REF) alone on a line as an embedded card. Documents live in the cloud, so they read back whether or not the user's computer is on. ref rewrites that document whole (the previous version is gone) and needs the if_revision read_document returned, or replace: true to overwrite it unread. Free. ## OpenAPI ````yaml /openapi.json post /tools/save_document openapi: 3.1.0 info: title: Eversince API version: '1' description: >- Every Eversince tool as one POST call, plus the routes beside them: the tool list, account and keys, uploads, webhooks and models. The prose is at https://docs.eversince.ai. servers: - url: https://eversince.ai/api/v1 security: - bearer: [] tags: - name: Discovery description: The tool list, the same on the MCP server, the REST API and the CLI. - name: Workspace description: Jobs, balances, settings, templates, skills and the overview. - name: Library description: >- Items, search, import, reading media, comments, boards, calendars, the brand kit and public links. - name: Timeline description: 'Video editing: timelines, clips, captions, sound, language and rendering.' - name: Canvas description: 'Still editing: canvases, slides, layers and rendering.' - name: Generation description: Image, video and audio generation, upscaling, cutouts and models. - name: Research description: 'What platforms publish: pulling and keeping posts.' - name: Account description: Balances, keys, workspaces and script sessions. - name: Uploads description: Files into the library by presigned upload or by URL. - name: Webhooks description: Job results posted to a URL as they complete. - name: Models description: Generation models and cost estimates. paths: /tools/save_document: post: tags: - Library summary: save document description: >- Save or rewrite a library document: markdown or plain text up to 200k bytes, with library items woven in as [Title](item:REF) inline or ![Caption](item:REF) alone on a line as an embedded card. Documents live in the cloud, so they read back whether or not the user's computer is on. ref rewrites that document whole (the previous version is gone) and needs the if_revision read_document returned, or replace: true to overwrite it unread. Free. operationId: save_document parameters: - $ref: '#/components/parameters/IdempotencyKey' - $ref: '#/components/parameters/WorkspaceId' requestBody: required: true content: application/json: schema: type: object properties: name: description: >- Document title (becomes the file name). Required when creating; ignored on rewrite. type: string minLength: 1 maxLength: 120 content: type: string minLength: 1 description: >- The whole document body, markdown or plain text, up to 200k bytes (Hebrew and Arabic take two bytes a letter, emoji four). On rewrite this replaces the body entirely. ref: description: >- An existing document to rewrite in place: the ones saved here and uploaded .md/.txt files; PDFs and Office files are viewed, not edited. Omit to create a new one. type: string if_revision: description: >- The revision read_document returned. A rewrite needs it, or replace; one that is out of date fails with revision_conflict rather than overwriting an edit you have not seen. type: integer replace: description: >- Rewrite over whatever the document says now, without reading it first. Otherwise pass if_revision. type: boolean folder: description: >- Destination folder: path ("campaigns/july") or id. Create only. type: string context: description: 'Optional: one sentence shown to the user beside this action.' type: string maxLength: 600 required: - content responses: '200': description: >- Done, or a job started for work that runs longer (follow it with get_jobs). content: application/json: schema: type: object required: - ok - data - meta properties: ok: const: true data: type: object additionalProperties: true meta: type: object properties: request_id: type: string cost: $ref: '#/components/schemas/Cost' cloud_processing: $ref: '#/components/schemas/CloudProcessing' media: type: array items: type: object additionalProperties: true default: $ref: '#/components/responses/Error' components: parameters: IdempotencyKey: name: Idempotency-Key in: header required: false schema: type: string description: >- Retry a paid dispatch safely: the same key returns the job already dispatched instead of charging again. WorkspaceId: name: x-workspace-id in: header required: false schema: type: string description: The workspace this one call acts in, when it is not the key's own. schemas: Cost: type: object description: AI credits the call cost. additionalProperties: true CloudProcessing: type: object description: Cloud processing the call used, and what is left. properties: ran_on: const: cloud minutes: type: number queued_minutes: type: number left_minutes: type: number bought_minutes: type: number note: type: string Error: type: object required: - ok - error properties: ok: const: false error: type: object required: - code - message - retryable properties: code: type: string message: type: string description: What went wrong, in words to act on. retryable: type: boolean suggested_action: type: string description: The next step that works. cloud_processing: $ref: '#/components/schemas/CloudProcessing' responses: Error: description: The call was refused or failed. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearer: type: http scheme: bearer description: >- An API key (es_live_…) from Settings, under API keys, or an OAuth access token. ````