---
title: "POST /vocabulary-remove/{InstanceId}/{VocabularyId}"
method: POST
path: "/vocabulary-remove/{InstanceId}/{VocabularyId}"
---

# POST /vocabulary-remove/{InstanceId}/{VocabularyId}

`POST /vocabulary-remove/{InstanceId}/{VocabularyId}`

Deletes the vocabulary that has the given identifier.

## Path parameters

- `InstanceId` string, required
- `VocabularyId` string, required

## Response `200`

Success

- DeleteVocabularyResponse
  - `VocabularyArn` string, required — The Amazon Resource Name (ARN) of the custom vocabulary.
  - `VocabularyId` string, required — The identifier of the custom vocabulary.
  - `State` 'CREATION_IN_PROGRESS' | 'ACTIVE' | 'CREATION_FAILED' | 'DELETE_IN_PROGRESS', required — The current state of the custom vocabulary.

## Other responses

- `480` — InvalidRequestException
- `481` — ResourceNotFoundException
- `482` — InternalServiceException
- `483` — ThrottlingException
- `484` — AccessDeniedException
- `485` — ResourceInUseException

---

[API](https://skmtc.net/aws/apis/connect.md) · [All operations](https://skmtc.net/aws/apis/connect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/connect/versions/fbcf0a4faed2/schema)