---
search:
  tags:
    - Objects and records
    - PATCH
seo:
  description: >-
    A label reaches every grid heading and the sidebar, so the update carries…
    Reference for the PATCH /api/v1/objects/{objectId} endpoint in the Taylorz
    CRM API.
sidebar:
  label: Rename an object
  badge: PATCH
title: Rename an object
type: openapi-operation
---
A label reaches every grid heading and the sidebar, so the update carries the revision it was read at and a stale one is refused.

`PATCH /api/v1/objects/{objectId}`

**Request body** (`application/json`, required)

- `key` (string)
- `label` (string, required)
- `revision` (integer, required)
- `singularLabel` (string | null)

Request body example:

```json
{
  "key": "string",
  "label": "string",
  "revision": 1,
  "singularLabel": "string"
}
```

**Responses**

- `200` — The object as it now stands
- `400` — The request body, query or parameters were refused
- `401` — The access token is missing, invalid or revoked
- `403` — The tenant's module is off, or the token's scope or the member's role does not permit the action
- `404` — No such record, or none the caller may read
- `409` — The operation conflicts with the current state
- `413` — The request exceeds the route's body limit
- `500` — An unexpected failure

Response example, 200:

```json
{
  "archivedAt": "2019-08-24T14:15:22Z",
  "createdAt": "2019-08-24T14:15:22Z",
  "id": "string",
  "key": "string",
  "kind": "standard",
  "label": "string",
  "moduleKey": "unavailable",
  "revision": 1
}
```