---
title: "Permanently revoke a Temp and delete its artifacts"
method: DELETE
path: "/temps/{tempId}"
tags: ["Lifecycle"]
---

# Permanently revoke a Temp and delete its artifacts

`DELETE /temps/{tempId}`

## Request

- Base URL: `https://api.temp.md`
- URL: `https://api.temp.md/temps/{tempId}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
- TypeScript: <https://skmtc.dev/temp-md/apis/temp-md-public-api/docs/temps/:tempId/delete.ts> (a function with typed inputs; its response is checked against the schema)

Immediately makes the public link unavailable, revokes scoped capabilities, and deletes every stored Version. If storage cleanup is temporarily unavailable, the link remains revoked while cleanup is retried in the background.

## Path parameters

- `tempId` string, required

## Headers

- `X-Tempmd-Client` string

## Response `200`

Temp revoked and artifacts deleted

- RevokeTempResult
  - `ok` unknown, required
  - `tempId` string, required
  - `canonicalUrl` string, uri, required
  - `status` 'revoked', required
  - `artifactsDeleted` integer, required
  - `cleanupPending` boolean, required
  - `message` string

## Other responses

- `202`: Temp revoked; artifact cleanup queued
- `401`: Authentication required or invalid
- `403`: Credential lacks access
- `404`: Resource not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/temp-md/apis/temp-md-public-api.md) - [All operations](https://skmtc.dev/temp-md/apis/temp-md-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/temp-md/apis/temp-md-public-api/revisions/4753682e1e3a?raw)