---
title: "Update object"
method: PATCH
path: "/crm/objects/{name}"
tags: ["crm"]
---

# Update object

`PATCH /crm/objects/{name}`

## Request

- Base URL: `https://www.dench.com/api/v1`
- URL: `https://www.dench.com/api/v1/crm/objects/{name}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Update a CRM object.

## Path parameters

- `name` string, required

## Request body

- object
  - `description` string
  - `defaultView` 'table' | 'kanban' | 'calendar' | 'timeline' | 'gallery' | 'list': Default view rendered for the object.
  - `icon` string
  - `viewSettings` object
  - `savedViews` object[]
  - `visibility` 'workspace' | 'owner_only' | 'owner_plus_members': Who can see the records of meeting, calendar_event or email_thread: every workspace member, only the record's owner, or the owner plus the members listed on the record. Admins only (a signed-in admin; an org-scoped key cannot change it). Every other CRM object is always shared with the workspace: owner_only / owner_plus_members on one answers 400; workspace is always accepted.

## Response `200`

Successful response

- object
  - `ok` boolean, required

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid authentication
- `404`: Operation or resource not found
- `500`: Server error

---

[API](https://skmtc.dev/dench/apis/dench-api.md) - [All operations](https://skmtc.dev/dench/apis/dench-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dench/apis/dench-api/revisions/4a145b38f19c?raw)
