---
title: "Update the draft (auto-forks if published)"
method: PATCH
path: "/v1/customer-ontologies/{id}"
tags: ["Customer Ontologies"]
---

# Update the draft (auto-forks if published)

`PATCH /v1/customer-ontologies/{id}`

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/customer-ontologies/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Request body

- OntologyUpdate
  - `name` string
  - `description` string
  - `doctypes` OntologyDoctype[]
    - `key` string, required
    - `name` string, required
    - `category` string
    - `maps_to` string: A Talonic ontology_type_id the doctype anchors to.
    - `description` string
    - `signals` string[]
  - `fields` OntologyField[]
    - `key` string, required
    - `canonical_name` string
    - `display_name` string
    - `data_type` string
    - `description` string
    - `synonyms` string[]
    - `doctype_scope` string: Custom doctype key, or null/empty/* for global.
    - `required` boolean
    - `format` string
    - `enum_values` string[]
    - `examples` string[]

## Response `200`

Updated version

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)
