> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rippit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# edit_table

> Change the saved description or the saved column metadata of a table or worksheet, open or not. One kind of edit per call: `description` or `operations`.

A non-empty description counts as user-written and automatic generation leaves it alone; clearing it lets generation write a new one. describe_table can show the previous description for up to a minute.

Labels, visibility, pinning, order and width work on every table; wrap, format, groups and delete are worksheet-only. Delete removes any column from a worksheet; use it only when the user asks for it. Formula, notes, enrichment and option columns, and their computation, are edited by their own tools. Unmentioned columns and attributes stay unchanged. Creating or renaming a group issues a new group id, which read_table's `columns[].groupId` shows.

`status: "applied"` means the edit is saved; after a column edit `updatedColumnIds` lists the changed columns.

This operation is an MCP tool today. Call it through the [Rippit MCP server](/mcp-server/overview) with the same name and parameters. The HTTP endpoint is not available yet.



## OpenAPI

````yaml /api-reference/tools-openapi.json post /v1/edit_table
openapi: 3.1.0
info:
  title: Rippit API
  version: 1.0.0
  description: >-
    Every operation is an MCP tool with the same name and parameters. The /v1
    HTTP endpoints are not available yet; call the tools through the Rippit MCP
    server.
servers:
  - url: https://api.rippit.com
security:
  - bearer: []
paths:
  /v1/edit_table:
    post:
      summary: edit_table
      description: >-
        Change the saved description or the saved column metadata of a table or
        worksheet, open or not. One kind of edit per call: `description` or
        `operations`.


        A non-empty description counts as user-written and automatic generation
        leaves it alone; clearing it lets generation write a new one.
        describe_table can show the previous description for up to a minute.


        Labels, visibility, pinning, order and width work on every table; wrap,
        format, groups and delete are worksheet-only. Delete removes any column
        from a worksheet; use it only when the user asks for it. Formula, notes,
        enrichment and option columns, and their computation, are edited by
        their own tools. Unmentioned columns and attributes stay unchanged.
        Creating or renaming a group issues a new group id, which read_table's
        `columns[].groupId` shows.


        `status: "applied"` means the edit is saved; after a column edit
        `updatedColumnIds` lists the changed columns.


        This operation is an MCP tool today. Call it through the [Rippit MCP
        server](/mcp-server/overview) with the same name and parameters. The
        HTTP endpoint is not available yet.
      operationId: edit_table
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                tableId:
                  type: string
                  minLength: 1
                  pattern: ^[A-Za-z0-9_-]+$
                  description: Id of a table or worksheet the user can edit.
                description:
                  description: Replacement table description. An empty string clears it.
                  type: string
                operations:
                  description: Column edits, applied in order.
                  minItems: 1
                  type: array
                  items:
                    oneOf:
                      - type: object
                        properties:
                          op:
                            type: string
                            const: rename
                            description: Rename the visible column header.
                          columnId:
                            type: string
                            minLength: 1
                            description: Column id to rename.
                          label:
                            type: string
                            minLength: 1
                            description: New visible column header. Must be non-blank.
                        required:
                          - op
                          - columnId
                          - label
                        additionalProperties: false
                      - type: object
                        properties:
                          op:
                            type: string
                            const: set_visibility
                            description: Hide or show one column.
                          columnId:
                            type: string
                            minLength: 1
                            description: Column id whose visibility to change.
                          hidden:
                            type: boolean
                            description: True hides; false shows.
                        required:
                          - op
                          - columnId
                          - hidden
                        additionalProperties: false
                      - type: object
                        properties:
                          op:
                            type: string
                            const: set_pinning
                            description: Pin or unpin the column.
                          columnId:
                            type: string
                            minLength: 1
                            description: Column id whose pinning to change.
                          pinned:
                            type: boolean
                            description: True pins; false unpins.
                        required:
                          - op
                          - columnId
                          - pinned
                        additionalProperties: false
                      - type: object
                        properties:
                          op:
                            type: string
                            const: reorder
                            description: >-
                              Move one column next to another, at most once per
                              column per request. Crossing the pinned boundary
                              requires an earlier set_pinning for that column in
                              the same request.
                          columnId:
                            type: string
                            minLength: 1
                            description: Column id to move.
                          anchorColumnId:
                            type: string
                            minLength: 1
                            description: Column id to place this column relative to.
                          position:
                            type: string
                            enum:
                              - before
                              - after
                          groupId:
                            description: >-
                              Worksheet-only column group change. Omit to
                              preserve the current group; use null to ungroup.
                            anyOf:
                              - type: string
                                minLength: 1
                              - type: 'null'
                        required:
                          - op
                          - columnId
                          - anchorColumnId
                          - position
                        additionalProperties: false
                      - type: object
                        properties:
                          op:
                            type: string
                            const: resize
                            description: Change the column width.
                          columnId:
                            type: string
                            minLength: 1
                            description: Column id to resize.
                          width:
                            type: number
                            exclusiveMinimum: 0
                            description: Pixels.
                        required:
                          - op
                          - columnId
                          - width
                        additionalProperties: false
                      - type: object
                        properties:
                          op:
                            type: string
                            const: delete
                            description: Remove columns from a worksheet. Worksheet-only.
                          columnIds:
                            minItems: 1
                            type: array
                            items:
                              type: string
                              minLength: 1
                            description: >-
                              One or more column ids to remove from the
                              worksheet.
                        required:
                          - op
                          - columnIds
                        additionalProperties: false
                      - type: object
                        properties:
                          op:
                            type: string
                            const: set_wrap_text
                            description: Wrap or unwrap cell text. Worksheet-only.
                          columnId:
                            type: string
                            minLength: 1
                            description: Column id whose wrapping to change.
                          wrapText:
                            type: boolean
                            description: True to wrap cell text; false to unwrap it.
                        required:
                          - op
                          - columnId
                          - wrapText
                        additionalProperties: false
                      - type: object
                        properties:
                          op:
                            type: string
                            const: set_format
                            description: Set number or date display format. Worksheet-only.
                          columnId:
                            type: string
                            minLength: 1
                            description: Column id whose format to change.
                          format:
                            anyOf:
                              - anyOf:
                                  - type: object
                                    properties:
                                      type:
                                        type: string
                                        const: number
                                      style:
                                        type: string
                                        enum:
                                          - plain
                                          - percent
                                      useThousandsSeparator:
                                        type: boolean
                                      maxDecimalPlaces:
                                        description: >-
                                          Decimal places to display, from 0 to
                                          100.
                                        type: integer
                                        minimum: 0
                                        maximum: 100
                                      prefix:
                                        type: string
                                      suffix:
                                        type: string
                                    required:
                                      - type
                                      - style
                                    additionalProperties: false
                                  - type: object
                                    properties:
                                      type:
                                        type: string
                                        const: date
                                      pattern:
                                        type: string
                                        enum:
                                          - '[Q]Q YYYY'
                                          - MMM YYYY
                                          - MMM D, YYYY
                                          - MMM D YYYY, h:mm A
                                          - YYYY-MM-DD HH:mm:ss
                                          - h:mm A
                                    required:
                                      - type
                                      - pattern
                                    additionalProperties: false
                              - type: 'null'
                            description: Null resets a date column to the source format.
                        required:
                          - op
                          - columnId
                          - format
                        additionalProperties: false
                      - type: object
                        properties:
                          op:
                            type: string
                            const: create_group
                            description: >-
                              Group columns under a shared header.
                              Worksheet-only.
                          columnIds:
                            minItems: 2
                            type: array
                            items:
                              type: string
                              minLength: 1
                          name:
                            type: string
                            minLength: 1
                            description: Visible group name. Must be non-blank.
                        required:
                          - op
                          - columnIds
                          - name
                        additionalProperties: false
                      - type: object
                        properties:
                          op:
                            type: string
                            const: rename_group
                            description: Rename a column group. Worksheet-only.
                          groupId:
                            type: string
                            minLength: 1
                            description: Encoded group id to rename.
                          name:
                            type: string
                            minLength: 1
                            description: New visible group name. Must be non-blank.
                        required:
                          - op
                          - groupId
                          - name
                        additionalProperties: false
                      - type: object
                        properties:
                          op:
                            type: string
                            const: ungroup
                            description: Remove columns from their group. Worksheet-only.
                          columnIds:
                            minItems: 1
                            type: array
                            items:
                              type: string
                              minLength: 1
                            description: One or more column ids to ungroup.
                        required:
                          - op
                          - columnIds
                        additionalProperties: false
              required:
                - tableId
              additionalProperties: false
      responses:
        '200':
          description: Tool result.
        '400':
          $ref: '#/components/responses/400'
        '401':
          $ref: '#/components/responses/401'
        '402':
          $ref: '#/components/responses/402'
        '403':
          $ref: '#/components/responses/403'
        '404':
          $ref: '#/components/responses/404'
        '422':
          $ref: '#/components/responses/422'
        '429':
          $ref: '#/components/responses/429'
        '504':
          $ref: '#/components/responses/504'
        5XX:
          $ref: '#/components/responses/5XX'
components:
  responses:
    '400':
      description: >-
        The arguments have a valid shape but refer to ids or values Rippit
        rejects. The same call fails again. Through MCP this is a tool result
        with `isError: true` whose text gives the status and a `Reference` id.
        See [Errors](/api-reference/errors).
    '401':
      description: >-
        The sign-in or token is no longer accepted. Sign in again, or reconnect
        Rippit in your assistant. Through MCP this is a tool result with
        `isError: true` whose text gives the status and a `Reference` id. See
        [Errors](/api-reference/errors).
    '402':
      description: >-
        The workspace reached its AI spend limit or is out of Credits. See
        [Billing and Credits](/billing). Through MCP this is a tool result with
        `isError: true` whose text gives the status and a `Reference` id. See
        [Errors](/api-reference/errors).
    '403':
      description: >-
        The user or workspace is not allowed to do this. Through MCP this is a
        tool result with `isError: true` whose text gives the status and a
        `Reference` id. See [Errors](/api-reference/errors).
    '404':
      description: >-
        An id in the call matches nothing you can see. Through MCP this is a
        tool result with `isError: true` whose text gives the status and a
        `Reference` id. See [Errors](/api-reference/errors).
    '422':
      description: >-
        The service does not accept one of the values. The message names the
        field. Through MCP this is a tool result with `isError: true` whose text
        gives the status and a `Reference` id. See
        [Errors](/api-reference/errors).
    '429':
      description: >-
        The call was rate limited and did not run. Wait a second and retry. See
        [Rate limits](/api-reference/rate-limits). Through MCP this is a tool
        result with `isError: true` whose text gives the status and a
        `Reference` id. See [Errors](/api-reference/errors).
    '504':
      description: >-
        The call timed out. For a read, ask for fewer rows or columns, or a
        narrower filter. Through MCP this is a tool result with `isError: true`
        whose text gives the status and a `Reference` id. See
        [Errors](/api-reference/errors).
    5XX:
      description: >-
        A Rippit service error. Retry a read; check before repeating a write.
        See [Idempotency and retries](/api-reference/idempotency). Through MCP
        this is a tool result with `isError: true` whose text gives the status
        and a `Reference` id. See [Errors](/api-reference/errors).
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.