> ## 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 boards > The workspace's boards. A board is a select field: its columns are the field's options and a card's column is the item's value, so it shows in the table, the item panel and every field filter. Placing or moving a card is update_items setting that field by name ({ fields: { "Nike Q3": "Approved" } }); clearing it takes the card off. get reads one board column by column, limit and cursor at a time. Names are unique across fields, so create fails on a name already taken. delete takes the word "delete" in confirm and is permanent: the board, its columns and every card's place go; the items stay. Free. ## OpenAPI ````yaml /openapi.json post /tools/manage_boards 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_boards: post: tags: - Library summary: manage boards description: >- The workspace's boards. A board is a select field: its columns are the field's options and a card's column is the item's value, so it shows in the table, the item panel and every field filter. Placing or moving a card is update_items setting that field by name ({ fields: { "Nike Q3": "Approved" } }); clearing it takes the card off. get reads one board column by column, limit and cursor at a time. Names are unique across fields, so create fails on a name already taken. delete takes the word "delete" in confirm and is permanent: the board, its columns and every card's place go; the items stay. Free. operationId: manage_boards parameters: - $ref: '#/components/parameters/IdempotencyKey' - $ref: '#/components/parameters/WorkspaceId' requestBody: required: true content: application/json: schema: type: object properties: action: type: string enum: - list - get - create - update - delete board: description: Board name or id, required for get, update and delete. type: string confirm: description: >- The word "delete", to delete the board named with its columns and every card's place on them. Permanent; the answer says what went; the items stay. type: string const: delete limit: description: >- get: how many cards to read, up to 500. The whole board when left out. type: integer exclusiveMinimum: 0 cursor: description: 'get: next_cursor from the read before, with the same board.' type: string name: description: >- The board's name (create), or its new name (update). Renaming the board renames the field, and the cards keep their columns. type: string description: description: >- What this board is for (create or update): the line another agent reads to tell two boards apart. type: string columns: description: >- Lay out columns left to right. On create this is the whole board; on update they are appended, and a name already on the board is skipped rather than duplicated. type: array items: type: object properties: name: type: string color: description: A label color token or hex; grey when left out. type: string required: - name update_columns: description: >- update: rename, recolor or set the limit on a column. Its cards keep their place in it. type: array items: type: object properties: column: type: string description: Column name or id. name: type: string color: type: string limit: description: >- How many cards this lane should hold at once; null clears it. Nothing is blocked at the limit; the count reads as over. anyOf: - type: number - type: 'null' required: - column reorder_columns: description: >- update: column names or ids in the order they should read left to right. Any left out keep their order behind them. type: array items: type: string delete_columns: description: >- update: remove these columns. Whatever sat in them comes OFF the board, since a column is what membership means; the items stay in the library. type: array items: type: string order_in_column: description: >- update: the vertical order inside a column, the order a user sets by dragging. A named card sitting elsewhere is skipped, not moved; changing columns is update_items. type: array items: type: object properties: column: type: string description: The column whose cards are being ordered. refs: minItems: 1 type: array items: type: string description: An item ref, item id, or the job id that made it. description: >- Cards top to bottom. Cards in the column but not named keep their order below these. required: - column - refs 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 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. ````