Delete collection (deletecollection)

Create a new style guide collection.

Request

Use the shared HTTP API endpoint and request formats.

See HTTP API Overview.

Parameters

Parameter	Type	Required	Default	Notes
cmd	string	Yes	style_guide	Command name.
action	string	Yes	deletecollection	Action name.
collection	string	Yes		The name of the collection to be deleted.
lang	string	No	common	Language scope to delete the collection in (example: en_US or en).

Behavior

• Delets an existing collection in the target lang scope.

• Returns the deleted collection info in result.

Response

Single result object containing deleted collection with it's category and lang .

See Response schema.

Errors

See

• Errors.

• Validation & limits

Examples

Example (JSON body)

Request URL (on-premises)

http(s)://server_entry_point/?cmd=style_guide&access_key=<your-access-key>&action=deletecollection&lang=en_US&collection=A test-collection

Request URL (Cloud)

https://svc.webspellchecker.net/api?cmd=style_guide&access_key=<your-access-key>&serviceid=<your-service-id>&action=deletecollection&lang=en_US&collection=A test-collection

Request CURL (on-premises)

curl -G "http(s)://server_entry_point" \
  --data-urlencode 'cmd=style_guide' \
  --data-urlencode 'access_key=<your-access-key>' \
  --data-urlencode 'action=deletecollection' \
  --data-urlencode 'lang=en_US' \
  --data-urlencode 'collection=A test-collection'

Request CURL (Cloud)

curl -G "https://svc.webspellchecker.net/api" \
  --data-urlencode 'cmd=style_guide' \
  --data-urlencode 'access_key=<your-access-key>' \
  --data-urlencode 'serviceid=<your-service-id>' \
  --data-urlencode 'action=deletecollection' \
  --data-urlencode 'lang=en_US' \
  --data-urlencode 'collection=A test-collection'

---

Response

{
    "message": "Collection deleted.",
    "collection_limit": 250,
    "collection_usage": 0,
    "result": [
        {
            "language": "en_US",
            "collection": "A test-collection",
            "category": "A_TEST-COLLECTION"
        }
    ]
}

Example (XML body)

Request URL (on-premises)

http(s)://server_entry_point/?cmd=style_guide&access_key=<your-access-key>&action=deletecollection&lang=en_US&collection=A test-collection&format=xml

Request URL (Cloud)

https://svc.webspellchecker.net/api?cmd=style_guide&access_key=<your-access-key>&serviceid=<your-service-id>&action=deletecollection&lang=en_US&collection=A test-collection&format=xml

Request CURL (on-premises)

curl -G "http(s)://server_entry_point" \
  --data-urlencode 'cmd=style_guide' \
  --data-urlencode 'access_key=<your-access-key>' \
  --data-urlencode 'action=deletecollection' \
  --data-urlencode 'lang=en_US' \
  --data-urlencode 'collection=A test-collection' \
  --data-urlencode 'format=xml'

Request CURL (Cloud)

curl -G "https://svc.webspellchecker.net/api" \
  --data-urlencode 'cmd=style_guide' \
  --data-urlencode 'access_key=<your-access-key>' \
  --data-urlencode 'serviceid=<your-service-id>' \
  --data-urlencode 'action=deletecollection' \
  --data-urlencode 'lang=en_US' \
  --data-urlencode 'collection=A test-collection' \
  --data-urlencode 'format=xml'

---

Response

<message>Collection deleted.</message>
<collection_limit>250</collection_limit>
<collection_usage>0</collection_usage>

<result>
	<category>
		<language>en_US</language>
		<collection>A test-collection</collection>
		<category>A_TEST-COLLECTION</category>
	</category>
</result>