Delete Container

The Delete Container endpoint permanently deletes a container.

Once deleted, the container and its encrypted contents can no longer be accessed or decrypted.

This operation cannot be undone.

Endpoint

DELETE /users/{user_id}/containers/{container_id}

Base URL:

https://share.locktera.com/api/v1

Full request URL example:

https://share.locktera.com/api/v1/users/USER_ID/containers/CONTAINER_I

Authentication

All requests must include a valid API key in the Authorization header.

Example request:

curl -X DELETE /users/YOUR_USER_ID/containers/CONTAINER_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

Authentication and authorization are verified before the container is deleted.

Path Parameters

container_id
Required. The unique identifier of the container to delete.

Example:

123e4567-e89b-12d3-a456-426614174000

Example Success Response

204 Deleted

This confirms the container has been successfully deleted.

Example Error Responses

HTTP 404 Not Found

{
  "error": "not_found",
  "message": "Container not found"
}

HTTP 401 Unauthorized

{
  "error": "unauthorized",
  "message": "Invalid API key"
}

HTTP 403 Forbidden

{
  "error": "access_denied",
  "message": "You do not have permission to delete this container"
}

What Happens When a Container Is Deleted

When a container is deleted:

• The container is permanently removed
• Encrypted file contents are no longer accessible
• Future decode requests will fail
• An audit event is recorded

Deleted containers cannot be recovered.

After deletion, the container_id remains invalid and cannot be reused.

Important Notes

• This operation is permanent
• Deleting a container removes access for all users
• Only authorized users can delete containers
• Audit logs will retain records of container activity

Deletion permanently removes all access regardless of DRM policy settings.

Related Endpoints

Encode Container

POST /users/{user_id}/containers/encode

Get Container Metadata

GET /users/{user_id}/containers/{container_id}

List Containers

GET /users/{user_id}/containers