Median

DELETE /conversations/{id}

Updated Oct 1, 20261 minute read

Delete a conversation

For good. Only archived conversations can be deleted; archive it first. Messages and their files are swept behind it.

Part of Conversations.

Parameters

NameInTypeRequiredDescription
idpathstringYesA conversation id.

Responses

StatusDescription
200Done.
400The request is malformed, and the message names the field.
401The bearer token is missing, revoked, or expired.
404Not one of yours, or not there at all.
429Too many requests. Wait the seconds in Retry-After. Limits depend on the plan. See rate limits.

200 body

FieldTypeRequiredDescription
okbooleanNo

Example response

{
  "ok": true
}

Example request

curl -X DELETE https://api.median.sh/v1/conversations/id \
  -H "Authorization: Bearer $BEARER_AUTH"

Still need help?

    Esc