curl --request PATCH \
  --url https://b.anny.co/api/v1/views/{view_uuid} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '
{
  "data": {
    "type": "views",
    "id": "9d001fc6-7cf2-4724-8752-3282ad1e1a42",
    "attributes": {
      "name": "Upcoming Bookings",
      "filters": {
        "upcomingOnly": true,
        "status": [
          "confirmed"
        ]
      }
    }
  }
}
'

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "type": "views",
    "attributes": {
      "name": "<string>",
      "area": "bookings",
      "filters": {},
      "columns": [
        "<string>"
      ],
      "config": {},
      "owner_type": "users",
      "owner_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    },
    "meta": {
      "is_shared": true
    },
    "links": {
      "self": "<string>"
    },
    "relationships": {
      "organization": {
        "data": {
          "id": "<string>",
          "type": "<string>"
        },
        "links": {
          "self": "<string>"
        }
      },
      "owner": {
        "data": {
          "id": "<string>",
          "type": "<string>"
        },
        "links": {
          "self": "<string>"
        }
      },
      "last_edited_by": {
        "data": {
          "id": "<string>",
          "type": "<string>"
        },
        "links": {
          "self": "<string>"
        }
      }
    }
  }
}

Personalization

Update a view

Update view attributes.

Authorization: the owner of a private (user-owned) view can always update it. Organization-owned (shared) views require the update ability on views — the default Admin/Super Admin roles can edit any shared view; roles without views abilities (e.g. Reception) receive 403. On 403, clients should offer “Save as new” (create a private copy) instead.

Side effect: every update stamps last_edited_by, which permanently opts a backend-seeded default view out of default-view reconciliation. Save only on explicit user intent, never as a rendering side effect.

For list areas, table layout (column order/visibility/widths + sort) is persisted inside config — merge over the existing config object, never replace it wholesale (it may carry backend-seeded meta keys such as requiredFeature). See the “Table State Persistence” guide.

PATCH

api

views

{view_uuid}

curl --request PATCH \
  --url https://b.anny.co/api/v1/views/{view_uuid} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/vnd.api+json' \
  --data '
{
  "data": {
    "type": "views",
    "id": "9d001fc6-7cf2-4724-8752-3282ad1e1a42",
    "attributes": {
      "name": "Upcoming Bookings",
      "filters": {
        "upcomingOnly": true,
        "status": [
          "confirmed"
        ]
      }
    }
  }
}
'

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "type": "views",
    "attributes": {
      "name": "<string>",
      "area": "bookings",
      "filters": {},
      "columns": [
        "<string>"
      ],
      "config": {},
      "owner_type": "users",
      "owner_id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    },
    "meta": {
      "is_shared": true
    },
    "links": {
      "self": "<string>"
    },
    "relationships": {
      "organization": {
        "data": {
          "id": "<string>",
          "type": "<string>"
        },
        "links": {
          "self": "<string>"
        }
      },
      "owner": {
        "data": {
          "id": "<string>",
          "type": "<string>"
        },
        "links": {
          "self": "<string>"
        }
      },
      "last_edited_by": {
        "data": {
          "id": "<string>",
          "type": "<string>"
        },
        "links": {
          "self": "<string>"
        }
      }
    }
  }
}

Autorisierungen

Authorization

string

header

erforderlich

The access token received from the authorization server in the OAuth 2.0 flow.

Header

Authorization

string

erforderlich

Bearer Token

Pfadparameter

view_uuid

string<uuid>

erforderlich

UUID of the view

Abfrageparameter

string

Organization ID

Body

application/vnd.api+json

data

object

Show child attributes

Antwort

data

View · object

Saved table/filter/display preset for an admin area.

Show child attributes

Guides

Customer API

Admin API

Data models

Customer internal API

Admin internal API

Identity API

Additional internal API

Update a view

Autorisierungen

Header

Pfadparameter

Abfrageparameter

Body

Antwort