Drop a table (HTTP)
|
For details about additional languages, see: |
Deletes a table from a database, including all data stored in the table.
|
Ready to write code? See the examples for this method to get started. |
Result
Deletes the specified table from the database, including all data stored in the table.
If the command succeeds, the response indicates the success.
Example successful response:
{
"status": {
"ok": 1
}
}
Parameters
Use the dropTable command.
Command signature
curl -sS -L -X POST "API_ENDPOINT/api/json/v1/KEYSPACE_NAME" \
--header "Token: APPLICATION_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"dropTable": {
"name": "TABLE_NAME"
}
}'
| Name | Type | Summary |
|---|---|---|
|
|
The name of the table to drop. |
Examples
The following examples demonstrate how to drop a table.
Drop a table by name
curl -sS -L -X POST "API_ENDPOINT/api/json/v1/KEYSPACE_NAME" \
--header "Token: APPLICATION_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"dropTable": {
"name": "TABLE_NAME"
}
}'
Drop a table only if the table exists
This option has no literal equivalent in HTTP. Instead, you can list the table names to see if a table with the name already exists.