---
title: "Actualiza un documento del workspace: name, category, is_pinned, el markdown (`content`) o el contenido de una grilla/presentación (`table` o `content_json`)"
method: POST
path: "/api/v1/update_workspace_file"
tags: ["Spaces"]
---

# Actualiza un documento del workspace: name, category, is_pinned, el markdown (\`content\`) o el contenido de una grilla/presentación (\`table\` o \`content_json\`)

`POST /api/v1/update_workspace_file`

## Request

- Base URL: `https://api.pymaia.com`
- URL: `https://api.pymaia.com/api/v1/update_workspace_file`
- Auth: HTTP bearer

Actualiza un documento del workspace: name, category, is_pinned, el markdown (`content`) o el contenido de una grilla/presentación (`table` o `content_json`). Sólo se escribe lo que mandás, y devuelve el documento actualizado con el link para abrirlo. Cuándo NO usarla: para crear uno nuevo es create_workspace_file, y para borrarlo delete_workspace_file. Si mandás `table` reemplaza la grilla ENTERA, no agrega filas.

## Request body

- object
  - `file_id` string, required
  - `name` string
  - `category` 'brand' | 'research' | 'strategy' | 'report' | 'other'
  - `content` string
  - `table` object: Reemplaza la grilla entera. El server genera los ids.
    - `headers` string[], required
    - `rows` array[], required
      - string[]
  - `content_json` union
    - object
      - `columns` object[], required
        - `id` string, required
        - `name` string, required
        - `type` 'text' | 'url' | 'dropdown' | 'file' | 'metric' | 'brand_voice' | 'audience' | 'agent' | 'prompt'
        - `options` string[]
      - `rows` object[], required
        - `id` string, required
        - `cells` object, required
      - `viewMode` 'condensed' | 'expanded'
    - object
      - `theme` 'pymaia' | 'helena' | 'minimal' | 'brand'
      - `slides` object[], required
        - `id` string, required
        - `type` string, required: Tipo de slide: 'title', 'content', 'bullets', 'image', 'chart'…
        - `layoutId` string: Layout: 'cover', 'bullet-list', 'two-columns', 'metric'…
        - `data` object: Campos del layout: title, subtitle, items, body…
  - `is_pinned` boolean

## Response `200`

Tool executed successfully

- object
  - `ok` boolean
  - `result` unknown
  - `duration_ms` number

## Other responses

- `400`: Invalid params or handler error
- `401`: Missing or invalid Bearer token
- `403`: Missing required scope(s) (`denied_scope`), or the tool's module is disabled for the organization (`module_disabled`, with `why`, `fix` and `module`)
- `404`: Tool not found, internal-only, or excluded for OAuth connectors
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/pymaia/apis/pymaia-api.md) · [All operations](https://skmtc.dev/pymaia/apis/pymaia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pymaia/apis/pymaia-api/revisions/705a6973177b?raw)