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

# Update a saved view

> Changes a saved view of yours: renames it, shares it with the organization or makes it private again (which takes it off the others' default), or saves over the search, filters, order and columns it keeps.



## OpenAPI

````yaml /openapi/en.json patch /api/v1/orgs/{orgId}/core/views/{viewId}
openapi: 3.1.0
info:
  title: Ready for Commerce API
  version: 1.0.0
  description: >-
    The reference of every operation of the Ready for Commerce API. Every
    operation is in beta until launch.
servers:
  - url: https://app.readyforcommerce.com
security:
  - apiKey: []
tags:
  - name: Credentials
    description: >-
      The credential that calls: its organization, its permissions, its limits
      and the calls it may still make.
  - name: Organization
    description: 'The organization''s settings: its name, slug and currency.'
  - name: Billing
    description: >-
      The organization's subscription and each module's bill and cap, and this
      month's usage against its free allowance.
  - name: Record types
    description: >-
      The kinds of record the credential may import or export, with each one's
      fields and options.
  - name: Imports
    description: >-
      Bring CSV or Excel files in: upload or fetch a file, inspect and check it,
      then start the import and read its results.
  - name: Files
    description: An uploaded file's status, until it is ready or rejected.
  - name: Exports
    description: Export the records a filter matches to CSV or Excel files, kept 14 days.
  - name: Export templates
    description: Saved export setups, by name, to run the same export again.
  - name: Jobs
    description: >-
      Long work runs as a job: follow its state and progress, read its messages,
      download its files or cancel it.
  - name: Search
    description: >-
      Find the organization's records by words, a typo included, grouped by
      kind.
  - name: Version history
    description: >-
      A record's versions, newest first: compare one with another and restore
      the record to it.
  - name: Incidents
    description: >-
      The organization's problems you may see: mark them read or unread, and
      resolve them.
  - name: Notifications
    description: >-
      Your notifications, newest first: mark one read or unread, or all of them
      read.
  - name: Saved views
    description: >-
      A table's search, filters, order and columns saved under a name, yours or
      shared with the organization, and the view each table opens with for you.
  - name: Store connections
    description: >-
      The organization's stores, connected with their pasted keys: list them,
      connect one, reconnect it with new keys or disconnect it.
  - name: Products
    description: >-
      The organization's products with their options, variants and prices: list
      them, read one, create one, change one's content, its prices or its
      status, duplicate one as a draft, or delete one.
paths:
  /api/v1/orgs/{orgId}/core/views/{viewId}:
    patch:
      tags:
        - Saved views
      summary: Update a saved view
      description: >-
        Changes a saved view of yours: renames it, shares it with the
        organization or makes it private again (which takes it off the others'
        default), or saves over the search, filters, order and columns it keeps.
      operationId: coreUpdateView
      parameters:
        - schema:
            type: string
            format: uuid
          in: path
          name: orgId
          required: true
        - schema:
            type: string
            format: uuid
          in: path
          name: viewId
          required: true
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateViewInput'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/View'
        default:
          description: >-
            An error, as `application/problem+json`: its `code` says what went
            wrong and `params` holds its values
          content:
            application/problem+json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/Problem'
                  - properties:
                      code:
                        enum:
                          - core.view_not_found
                          - core.view_resource_not_found
                          - core.view_needs_person
                          - core.view_not_owner
                          - core.view_unreadable
                          - core.view_name_taken
                          - core.bad_request
                          - core.invalid_credential
                          - core.forbidden
                          - core.module_not_enabled
                          - core.module_read_only
                          - core.not_found
                          - core.conflict
                          - core.org_deletion_scheduled
                          - core.payload_too_large
                          - core.unsupported_media_type
                          - core.validation_failed
                          - core.rate_limited
                          - core.surface_disabled
                          - core.internal
                          - core.unavailable
components:
  schemas:
    UpdateViewInput:
      type: object
      properties:
        name:
          type: string
          minLength: 1
          maxLength: 30
        visibility:
          type: string
          enum:
            - private
            - org
        state:
          type: object
          properties:
            question:
              type: object
              properties:
                search:
                  type: string
                filter:
                  type: object
                  properties:
                    items:
                      maxItems: 100
                      type: array
                      items:
                        type: object
                        properties:
                          field:
                            type: string
                          op:
                            type: string
                          value: {}
                        required:
                          - field
                          - op
                    logic:
                      type: string
                      enum:
                        - and
                        - or
                      examples:
                        - and
                  required:
                    - items
                    - logic
                sort:
                  type: object
                  properties:
                    field:
                      type: string
                    direction:
                      type: string
                      enum:
                        - asc
                        - desc
                      examples:
                        - asc
                  required:
                    - field
                    - direction
            columns:
              type: array
              items:
                type: string
            hide:
              type: array
              items:
                type: string
          required:
            - question
          additionalProperties: false
    View:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        visibility:
          type: string
          enum:
            - private
            - org
        state:
          type: object
          properties:
            question:
              type: object
              properties:
                search:
                  type: string
                filter:
                  type: object
                  properties:
                    items:
                      maxItems: 100
                      type: array
                      items:
                        type: object
                        properties:
                          field:
                            type: string
                          op:
                            type: string
                          value: {}
                        required:
                          - field
                          - op
                        additionalProperties: false
                    logic:
                      type: string
                      enum:
                        - and
                        - or
                  required:
                    - items
                    - logic
                  additionalProperties: false
                sort:
                  type: object
                  properties:
                    field:
                      type: string
                    direction:
                      type: string
                      enum:
                        - asc
                        - desc
                  required:
                    - field
                    - direction
                  additionalProperties: false
              additionalProperties: false
            columns:
              type: array
              items:
                type: string
            hide:
              type: array
              items:
                type: string
          required:
            - question
          additionalProperties: false
        mine:
          type: boolean
        default:
          type: boolean
      required:
        - id
        - name
        - visibility
        - state
        - mine
        - default
      additionalProperties: false
    Problem:
      type: object
      properties:
        type:
          type: string
          pattern: ^urn:rfc:problem:[\s\S]{0,}\.[\s\S]{0,}$
        status:
          type: integer
        title:
          type: string
        code:
          type: string
          pattern: ^[\s\S]{0,}\.[\s\S]{0,}$
        params:
          type: object
          propertyNames:
            type: string
          additionalProperties: {}
        requestId:
          type: string
        errors:
          type: array
          items:
            type: object
            properties:
              location:
                type: string
              pointer:
                type: string
              code:
                type: string
              params:
                type: object
                propertyNames:
                  type: string
                additionalProperties: {}
            required:
              - location
              - pointer
              - code
            additionalProperties: false
      required:
        - type
        - status
        - code
        - requestId
      additionalProperties: false
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        An organization's API key, sent on every call as `Authorization: Bearer
        <key>`. A person of the organization creates it in the app, in
        **Settings › API and connections › API keys**.

````

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