---
title: "Unpublish Agent"
method: DELETE
path: "/api/agents/{agent_id}/publish"
tags: ["public"]
---

# Unpublish Agent

`DELETE /api/agents/{agent_id}/publish`

## Request

- Base URL: `https://api.parlel.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.parlel.com/api/agents/{agent_id}/publish`
- Auth: none declared

Take the public page offline immediately.

Nulls the slug, which is what every public read filters on, so the page and
every receipt derived from it 404 from the next request onward. ``clone_count``
survives (those clones still exist and still point here) and so does
``published_at``, so re-publishing does not rewrite history — though it does
mint a *new* slug, because the old URL was withdrawn and handing it back out
would resurrect links the owner deliberately broke.

Followers survive too, dormant, and one read does NOT filter them out:
``GET /api/follows`` still lists this agent to the people who follow it, by
name only, flagged ``dormant`` (see ``routes/follows.py``). The brief and the
findings stay behind the boundary this endpoint just closed — a follower is
told their subscription has gone quiet, not what it used to watch.

## Path parameters

- `agent_id` string, required

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/parlel/apis/parlel-api.md) · [All operations](https://skmtc.dev/parlel/apis/parlel-api/llms.txt) · [OpenAPI document](https://skmtc.dev/parlel/apis/parlel-api/revisions/4d41a8f5cfc9?raw)