---
title: Delete property group
slug: cms-13/api/delete-property-group
docTags:
createdAt: 2026-08-28T15:24:16.532Z
---
{
"id": "qBvzbOrXS14JQxVpqLkvS",
"type": "api-oas-v2",
"data": {
"method": "DELETE",
"url": "/_cms/v1/propertygroups/{key}",
"servers": [
{
"url": "/_cms/v1/propertygroups/{key}",
"description": "Optimizely CMS API"
}
],
"name": "Delete property group",
"description": "Deletes the property group with the provided key.",
"contentType": "application/json",
"request": {
"pathParameters": [
{
"kind": "required",
"name": "key",
"type": "string",
"description": "The key of the property group to delete."
}
],
"headerParameters": [
{
"name": "accept",
"type": "string",
"kind": "optional",
"description": "Generated from available response content types",
"enum": [
"application/json"
],
"default": "application/json"
},
{
"kind": "optional",
"name": "Prefer",
"type": "array",
"example": "[\"return=representation\"]",
"description": "Indicates client preference for the response content as per IETF RFC7240. Currently only supports 'return=representation' which can be used to indicate a preference to receive a representation of the resource that has been altered in the response.
",
"schema": [],
"itemType": "string",
"customType": "string[]"
},
{
"kind": "optional",
"name": "If-Match",
"type": "string",
"description": "If provided, the DELETE request will only be considered if the value matches the RFC7232 ETag of the current resource. Weak ETags will always be ignored.
"
},
{
"kind": "optional",
"name": "If-Unmodified-Since",
"type": "string",
"description": "If provided, the DELETE request will only be considered if the resource has not been modified since the provided date. This parameter will be ignored if an 'If-Match' parameter is also provided.
",
"format": "http-date"
}
],
"queryParameters": [],
"bodyDataParameters": [],
"formDataParameters": [],
"oAuthParameters": [
{
"id": "apiAuth",
"name": "apiAuth",
"kind": "optional",
"type": "oauth2",
"description": "Use this scheme to generate an access token that can be used to access the API.",
"oauth2Flows": {
"clientCredentials": {
"tokenUrl": "/_cms/v1/oauth/token",
"scopes": {
"api:admin": "Grants full administrative access to the API"
}
}
},
"requiredScopes": [
"api:admin"
]
}
],
"cookieParameters": []
},
"responses": [
{
"statusCode": "200",
"description": "OK",
"jsonExample": "",
"isExpanded": true,
"headers": [
{
"kind": "optional",
"name": "Preference-Applied",
"description": ""
}
],
"schema": [
{
"kind": "optional",
"type": "object",
"description": "Describes a property group of a ContentType in the CMS.",
"customType": "PropertyGroup",
"schema": [
{
"name": "key",
"kind": "required",
"type": "string",
"description": "The unique identifier (key) of the resource.
",
"minLength": 2,
"maxLength": 255,
"pattern": "^[A-Za-z][_0-9A-Za-z]+$"
},
{
"name": "displayName",
"kind": "required",
"type": "string",
"description": "The display name of this PropertyGroup.",
"minLength": 1,
"maxLength": 255
},
{
"name": "source",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "A string that indicates the source of this property group. Can be used to distinguish property groups created by the system from types coming from model classes deployed to the CMS server."
},
{
"name": "sortOrder",
"kind": "optional",
"type": "integer",
"description": "A value that is used to when sorting PropertyGroup instances.",
"format": "int32"
},
{
"name": "created",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "A timestamp indicating when this property group was first created.",
"format": "date-time"
},
{
"name": "createdBy",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The username of the user that created this property group."
},
{
"name": "lastModified",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "",
"format": "date-time"
},
{
"name": "lastModifiedBy",
"kind": "optional",
"type": "string",
"readOnly": true,
"description": "The username of the user that last modified this property group."
}
],
"modelRef": "#/components/schemas/PropertyGroup",
"isExpanded": true
}
]
},
{
"statusCode": "204",
"description": "No Content",
"jsonExample": "",
"isExpanded": true
},
{
"statusCode": "400",
"description": "Bad Request",
"jsonExample": "",
"isExpanded": true
},
{
"statusCode": "401",
"description": "Unauthorized",
"jsonExample": "",
"isExpanded": true
},
{
"statusCode": "403",
"description": "Forbidden",
"jsonExample": "",
"isExpanded": true
},
{
"statusCode": "404",
"description": "Not Found",
"jsonExample": "",
"isExpanded": true
},
{
"statusCode": "412",
"description": "Precondition Failed",
"jsonExample": "",
"isExpanded": true
},
{
"statusCode": "500",
"description": "Internal Server Error",
"jsonExample": "",
"isExpanded": true
}
],
"hasXCodeSamples": false,
"examples": {
"languages": [
{
"id": "Qax0ubeqSsbew0iwzkODw",
"language": "curl",
"label": "cURL",
"code": "curl --request DELETE \\\n --url /_cms/v1/propertygroups/{key} \\\n --header 'accept: application/json'"
},
{
"id": "5clr7NBkX_29cAPQp3-9J",
"language": "javascript",
"label": "javascript",
"code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\n\nvar requestOptions = {\n method: 'DELETE',\n headers: myHeaders,\n redirect: 'follow'\n};\n\nfetch(\"/_cms/v1/propertygroups/{key}\", requestOptions)\n .then(response => response.text())\n .then(result => console.log(result))\n .catch(error => console.log('error', error));"
},
{
"id": "_m-As2XG1kHQDjVJgxzkn",
"language": "ruby",
"label": "Ruby",
"code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"/_cms/v1/propertygroups/{key}\")\n\nhttp = Net::HTTP.new(url.host, url.port);\nrequest = Net::HTTP::Delete.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\n\nresponse = http.request(request)\nputs response.read_body\n"
},
{
"id": "Orb8eAysY9QFQBTX3sIGL",
"language": "python",
"label": "Python",
"code": "import requests\nimport json\n\nurl = \"/_cms/v1/propertygroups/{key}\"\n\npayload = {}\nheaders = {\n 'accept': 'application/json',\n 'content-type': 'application/json'\n}\n\nresponse = requests.request(\"DELETE\", url, headers=headers, data=payload)\n\nprint(response.text)\n"
}
],
"selectedLanguageId": "Qax0ubeqSsbew0iwzkODw"
},
"results": {
"languages": [
{
"id": "response-0-200",
"language": "200",
"code": "// OK\n{\n \"key\": \"\",\n \"displayName\": \"\",\n \"source\": \"\",\n \"sortOrder\": \"\",\n \"created\": \"\",\n \"createdBy\": \"\",\n \"lastModified\": \"\",\n \"lastModifiedBy\": \"\"\n}"
},
{
"id": "response-1-204",
"language": "204",
"code": "// No Content\n"
},
{
"id": "response-2-400",
"language": "400",
"code": "// Bad Request\n"
},
{
"id": "response-3-401",
"language": "401",
"code": "// Unauthorized\n"
},
{
"id": "response-4-403",
"language": "403",
"code": "// Forbidden\n"
},
{
"id": "response-5-404",
"language": "404",
"code": "// Not Found\n"
},
{
"id": "response-6-412",
"language": "412",
"code": "// Precondition Failed\n"
},
{
"id": "response-7-500",
"language": "500",
"code": "// Internal Server Error\n"
}
],
"selectedLanguageId": "response-0-200"
}
},
"children": [
{
"text": ""
}
]
}