> ## 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. # manage cards > Cards on a board or calendar: a title, a markdown body, attached library items and the workspace's labels. A card lives on one board, between its columns, or one calendar, between its days, and is not a library item. list takes on (a board or calendar) and, for a calendar, from and to; read returns the body, attachments and revision; update and delete take card_id, and update needs if_revision from read. Deleting a card leaves its attachments in the library. Free. ## OpenAPI ````yaml /openapi.json post /tools/manage_cards 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/manage_cards: post: tags: - Library summary: manage cards description: >- Cards on a board or calendar: a title, a markdown body, attached library items and the workspace's labels. A card lives on one board, between its columns, or one calendar, between its days, and is not a library item. list takes on (a board or calendar) and, for a calendar, from and to; read returns the body, attachments and revision; update and delete take card_id, and update needs if_revision from read. Deleting a card leaves its attachments in the library. Free. operationId: manage_cards parameters: - $ref: '#/components/parameters/IdempotencyKey' - $ref: '#/components/parameters/WorkspaceId' requestBody: required: true content: application/json: schema: type: object properties: action: type: string enum: - list - read - create - update - delete 'on': description: >- Board or calendar, by name or id. Required for list and create. type: string card_id: description: Required for read, update and delete. type: string place: description: >- Board column by name or id, or calendar day as YYYY-MM-DD. Required for create; on update, moves the card within its board or calendar. type: string title: description: Required for create. type: string minLength: 1 maxLength: 200 body: description: >- Markdown as in save_document, up to 20,000 characters. Empty clears it; omitted keeps it. type: string maxLength: 20000 attachments: description: >- The complete ordered list of library refs or ids. Empty removes every one; omitted keeps them. maxItems: 50 type: array items: type: string labels: description: >- The complete list of labels by name or id. Empty removes every one; omitted keeps them. maxItems: 20 type: array items: type: string position: description: >- update, on a board: the card's place in its column, top to bottom, lower first. type: number from: description: 'Calendar list: first day, YYYY-MM-DD.' type: string to: description: 'Calendar list: last day, YYYY-MM-DD.' type: string if_revision: description: >- The revision from read. Required for update; a stale one refuses the write. type: string context: description: 'Optional: one sentence shown to the user beside this action.' type: string maxLength: 600 required: - action 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 default: for a key or a connected agent, one of the workspaces the user allowed it. schemas: Cost: type: object description: AI credits the call cost. additionalProperties: true CloudProcessing: type: object description: >- Cloud processing for this call. minutes is the estimate. charged_minutes is what work that finished inside the call was charged; work still running or queued is charged when it finishes, and get_jobs reports it as cloud_minutes. left_minutes is the month after held_minutes, which running work holds until it settles. properties: ran_on: const: cloud minutes: type: number charged_minutes: type: number queued_minutes: type: number left_minutes: type: number held_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. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.