---
title: "Update base"
method: PATCH
path: "/api/v3/meta/bases/{baseId}"
tags: ["Bases"]
---

# Update base

`PATCH /api/v3/meta/bases/{baseId}`

## Request

- Base URL: `https://app.nocodb.com`
- URL: `https://app.nocodb.com/api/v3/meta/bases/{baseId}`
- Auth: one of:
  - API key in header `xc-token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/nocodb/apis/nocodb-v3/docs/api/v3/meta/bases/:baseId/patch.ts> (a function with typed inputs; its response is checked against the schema)

Update properties of a specific base. You can modify fields such as the title and metadata of the base. The baseId parameter identifies the base to be updated, and the new details must be provided in the request body. At least one of title or meta must be provided.

## Path parameters

- `baseId` string, required

## Request body

- BaseUpdate
  - `title` string: Title of the base.
  - `meta` BaseMetaReq
    - `icon_color` string: Specifies the color of the base icon using a hexadecimal color code (e.g., `#36BFFF`). **Constraints**: - Must be a valid 6-character hexadecimal color code preceded by a `#`. - Optional field; defaults to a standard color if not provided.

## Response `200`

The base was updated.

- Base
  - `id` string, required: Unique identifier for the base.
  - `title` string, required: Title of the base.
  - `meta` BaseMetaRes, required
    - `icon_color` string: Specifies the color of the base icon using a hexadecimal color code (e.g., `#36BFFF`)
  - `created_at` string, date-time, required: Timestamp of when the base was created.
  - `updated_at` string, date-time, required: Timestamp of when the base was last updated.
  - `workspace_id` string, required: Unique identifier for the workspace to which this base belongs to.
  - `sources` object[]: List of data sources associated with this base. This information will be included only if one or more external data sources are associated with the base.
    - `id` string, required: Unique identifier for the data source.
    - `title` string, required: Title of the data source.
    - `type` string, required: Type of the data source (e.g., pg, mysql).
    - `is_schema_readonly` boolean, required: Indicates if the schema in this data source is read-only.
    - `is_data_readonly` boolean, required: Indicates if the data (records) in this data source is read-only.
    - `integration_id` string, required: Integration ID for the data source.

## Other responses

- `400`: Invalid request body.
- `404`: Base not found.
- `500`: Server error.

---

[API](https://skmtc.dev/nocodb/apis/nocodb-v3.md) - [All operations](https://skmtc.dev/nocodb/apis/nocodb-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/nocodb/apis/nocodb-v3/revisions/62a735aaf849?raw)