Skip to content

Remove an endpoint from the catalog

DELETE
/v1/api-endpoints/{id}
curl --request DELETE \
--url https://beta-api.plune.ai/v1/api-endpoints/example \
--header 'Authorization: Bearer <token>'

A person, or a token without X-Plune-Session: an agent is refused (403 agent_cannot_delete), as on every DELETE. The links to the cases that test it go; the cases, and the results of past runs, stay. An import of a spec that has it adds it again.

id
required
string

The endpoint’s id

Removed

No / invalid token or session

A reader, a read token, or an agent (agent_cannot_delete)

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

No such endpoint in your project

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

Rate-limited: the per-route throttle, or the per-minute request limit of the plan an API token counts by (#1442; the body names the plan, #2092). Retry-After carries the seconds until the window rolls over.

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}
Retry-After
integer

Seconds until the window rolls over