Conversations

Discard an admin’s draft

Discards the draft that Put a draft in an admin's composer put into an admin's composer for a conversation. The composer goes back to what it held before the draft, in every browser. Text the admin typed into the draft in a browser stays there.

DELETE

/v2/conversations/{id}/draft

curl --request DELETE \
  --url 'https://do.featurebase.app/v2/conversations/{id}/draft?messageType=reply' \
  --header 'Authorization: Bearer <token>' \
  --header 'Featurebase-Version: 2026-08-19.orbit' \
  --header 'Content-Type: application/json' \
  --data '
{
  "adminId": "507f1f77bcf86cd799439011"
}
'

{
  "data": [
    {
      "admin": {
        "id": "507f1f77bcf86cd799439011",
        "name": "Robi"
      },
      "bodyHtml": "<p>Hi Anna,</p><p></p><p>Thanks for the details!</p>",
      "conversationId": "12345",
      "createdAt": "2026-10-19T12:30:00.000Z",
      "dashboardUrl": "https://acme.featurebase.app/dashboard/inbox/all/conversation/12345",
      "expiresAt": "2026-11-18T12:30:00.000Z",
      "id": "6720f1c2a9b8c7d6e5f40312",
      "messageType": "reply",
      "object": "conversation_draft",
      "status": "pending"
    }
  ],
  "object": "list"
}

adminId names the admin, the same way as when the draft was put in. The Featurebase MCP server may leave it out: it always discards the drafts of the admin who connected it.

Path Parameters

id - The conversation ID (short ID)

Query Parameters

messageType - Optional. "reply" or "note" discards only that draft; both are discarded when omitted.

Request Body

Field	Type	Required	Description
`adminId`	string	Yes	The admin whose draft is discarded. Must be a member of the organization.

Example Request

{
  "adminId": "507f1f77bcf86cd799439011"
}

Response

Returns the discarded drafts. Returns 404 when there is no pending draft to discard.

Version Availability

This endpoint is only available in API version 2026-01-01.nova and newer.

Autorizaciones

Authorizationstringheaderobligatorio

API key as Bearer token. Use: Authorization: Bearer sk_...

Parámetros de ruta

idstringobligatorio

Conversation ID (short ID)

Required string length: 1 - 16

Patrón: ^[a-zA-Z0-9]+$

Ejemplo: 12345

Parámetros de consulta

messageTypeenum<string>query

Discard only the reply draft or only the note draft. Both when omitted.

Opciones disponibles: reply, note

Ejemplo: reply

Encabezados

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Opciones disponibles: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover

Ejemplo: 2026-08-19.orbit

Cuerpo

adminIdstringobligatorio

The admin whose draft is discarded. Must be a member of the organization.

Ejemplo: 507f1f77bcf86cd799439011

Respuesta

Success

dataobject[]obligatorio

The discarded drafts (status "discarded")

Mostrar child attributes

objectenum<string>obligatorio

Object type identifier

Opciones disponibles: list

Ejemplo: list

¿Aún necesitas ayuda? Pregunta al equipo