DELETE
/v1/documents/:id/publishUnpublish Document
Remove a document from its public URL.
Remove a document from its public URL. The document itself is not deleted and remains in your account. You can republish it later.
After unpublishing, the previously public URL will return a 404.
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | Yes | The document UUID |
Response
Returns a confirmation with the updated publish status.
| Field | Type | Description |
|---|---|---|
id | string | Document UUID |
is_published | boolean | Always false after unpublishing |
Errors
| Status | Code | Description |
|---|---|---|
| 401 | unauthorized | Missing or invalid API key |
| 404 | not_found | Document not found or does not belong to you |
| 500 | internal_error | Unexpected server error |
curl -X DELETE https://api.unmarkdown.com/v1/documents/doc_abc123/publish \
-H "Authorization: Bearer um_your_key"
const res = await fetch(
'https://api.unmarkdown.com/v1/documents/doc_abc123/publish',
{
method: 'DELETE',
headers: {
'Authorization': 'Bearer um_your_key'
}
}
);
const data = await res.json();
console.log(data.is_published); // false
import requests
res = requests.delete(
'https://api.unmarkdown.com/v1/documents/doc_abc123/publish',
headers={'Authorization': 'Bearer um_your_key'}
)
print(res.json())
Response
{
"id": "doc_abc123",
"is_published": false
}