Delete Request

DELETE /shorts/:id

Permanently deletes a short creation request and all associated generated shorts. If the request is currently being processed, processing will be cancelled before deletion.

Path parameters

Request

curl -X DELETE \
  -H "X-API-Key: sk_ssemble_your_key" \
  https://aiclipping.ssemble.com/api/v1/shorts/665a1b2c3d4e5f6a7b8c9d0e

Response

{
  "data": {
    "message": "Request successfully deleted"
  }
}

What gets deleted

When you delete a request, the following are permanently removed:

• Request record — The request metadata (URL, parameters, timestamps)
• Generated shorts — All video files produced by this request
• Processing data — Transcriptions, clip selections, and rendering artifacts

If the request is actively being processed (status: "processing"), the processing job is cancelled immediately before the data is deleted.

Error responses

Error examples

Invalid ID format

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request ID format",
    "details": null
  }
}

Request not found

{
  "error": {
    "code": "resource_not_found",
    "message": "Request not found or does not belong to your account",
    "details": null
  }
}

This can happen if:

• The request ID doesn't exist
• The request belongs to a different API key / account
• The request was already deleted

Bulk deletion

To delete multiple requests, loop through them individually. There is no bulk delete endpoint.

async function deleteCompletedRequests(apiKey) {
  // First, list completed requests
  const listRes = await fetch(
    'https://aiclipping.ssemble.com/api/v1/shorts?status=completed&limit=100',
    { headers: { 'X-API-Key': apiKey } }
  );
  const { data } = await listRes.json();
 
  let deleted = 0;
  for (const req of data.requests) {
    const deleteRes = await fetch(
      `https://aiclipping.ssemble.com/api/v1/shorts/${req.requestId}`,
      {
        method: 'DELETE',
        headers: { 'X-API-Key': apiKey }
      }
    );
 
    if (deleteRes.ok) {
      deleted++;
      console.log(`Deleted: ${req.requestId}`);
    }
 
    // Small delay to respect rate limits
    await new Promise(r => setTimeout(r, 200));
  }
 
  console.log(`Deleted ${deleted} of ${data.requests.length} requests`);
}

Important notes

• This action is irreversible. Once deleted, the request and all generated videos cannot be recovered.
• If the request is actively being processed, the processing job is cancelled before deletion. No partial results are saved.
• Credits consumed by the request are not refunded upon deletion. Each POST /shorts/create call permanently consumes 1 credit regardless of whether the result is later deleted.
• You can only delete requests created by your own API key. Attempting to delete another account's requests returns 404.