Skip to main content
PATCH
/
publisher
/
{publisher_id}
/
entities
/
content-type
/
{custom_entity_schema_id}
Update Custom Content Type
curl --request PATCH \
  --url https://cms.thepublive.com/publisher/{publisher_id}/entities/content-type/{custom_entity_schema_id} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "api_slug": "<string>",
  "api_collections_slug": "<string>",
  "response_type": "<string>",
  "field_types": [
    {}
  ]
}
'
{
  "status": "success",
  "message": "Updated Successfully",
  "data": {
    "id": "sch_abc123",
    "type": "Collection",
    "name": "Movies",
    "api_slug": "movie",
    "api_collections_slug": "movies",
    "response_type": "json",
    "field_types": [
      {
        "name": "fame",
        "type": "short_text",
        "validations": { "required": {}, "group_editable": true },
        "meta_data": {
          "type": { "value": "input" },
          "label": { "value": "fame" },
          "placeholder": { "value": "Actor is" },
          "default": { "value": null },
          "tooltip": { "value": "" }
        }
      }
    ],
    "groups": [],
    "components": [],
    "settings": {
      "entry_title": "name",
      "searchable_fields": [],
      "filter_fields": [],
      "allowed_states": ["Published", "Draft", "Scheduled", "Approval Pending"],
      "access_control": {},
      "enable_component_preview": false,
      "enable_content_rule": false,
      "enable_custom_date": false,
      "enable_seo_properties": false,
      "enable_code_ingestion": false
    },
    "global_system_default": false
  }
}
Updates an existing custom content type schema. Only send the fields you want to change (partial update).
​
publisher_id
string
required
Your Publisher ID
​
custom_entity_schema_id
string
required
Custom content type schema ID
​
name
string
Display name for the content type
​
api_slug
string
Singular API slug for single-entry endpoints
​
api_collections_slug
string
Plural API slug for collection endpoints
​
response_type
string
Response format. Currently supports json.
​
field_types
array
Replaces the field definitions for the schema. Each object supports:
KeyTypeRequiredDescription
namestringYesField identifier
typestringYesField type: short_text, long_text, url, integer, boolean, media, etc.
meta_dataobjectNoUI metadata — label, tooltip, type, placeholder, default (each wrapped as {"value": ...})
validationsobjectNoValidation rules — required, group_editable
group_idstringNoField group assignment

​
Example Request

curl -X PATCH \
  'https://cms.thepublive.com/publisher/123/entities/content-type/sch_abc123' \
  -H 'Authorization: Basic <BASE64_AUTH_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Movies",
    "api_slug": "movie",
    "api_collections_slug": "movies",
    "response_type": "json",
    "field_types": [
      {
        "name": "fame",
        "type": "short_text",
        "validations": { "required": {}, "group_editable": true },
        "meta_data": {
          "type": { "value": "input" },
          "label": { "value": "fame" },
          "placeholder": { "value": "Actor is" },
          "default": { "value": null },
          "tooltip": { "value": "" }
        }
      }
    ]
  }'

{
  "status": "success",
  "message": "Updated Successfully",
  "data": {
    "id": "sch_abc123",
    "type": "Collection",
    "name": "Movies",
    "api_slug": "movie",
    "api_collections_slug": "movies",
    "response_type": "json",
    "field_types": [
      {
        "name": "fame",
        "type": "short_text",
        "validations": { "required": {}, "group_editable": true },
        "meta_data": {
          "type": { "value": "input" },
          "label": { "value": "fame" },
          "placeholder": { "value": "Actor is" },
          "default": { "value": null },
          "tooltip": { "value": "" }
        }
      }
    ],
    "groups": [],
    "components": [],
    "settings": {
      "entry_title": "name",
      "searchable_fields": [],
      "filter_fields": [],
      "allowed_states": ["Published", "Draft", "Scheduled", "Approval Pending"],
      "access_control": {},
      "enable_component_preview": false,
      "enable_content_rule": false,
      "enable_custom_date": false,
      "enable_seo_properties": false,
      "enable_code_ingestion": false
    },
    "global_system_default": false
  }
}
Last modified on April 23, 2026