For AI agents: markdown of this page — /docs-content-en/openlines/quick-replies/delete.md documentation index — /llms.txt

Delete a quick reply

DELETE /v1/openline-configs/:lineId/quick-replies/:id

Deletes an Open Channel quick reply by its ID, provided the reply belongs to the channel specified in the request path. A deleted reply cannot be restored through the API — create a new one if needed.

Parameters

Parameter Type Required Description
ParameterlineId (path) Typeinteger Requiredyes DescriptionOpen Channel ID. List: GET /v1/openline-configs
Parameterid (path) Typeinteger Requiredyes DescriptionID of a quick reply in this channel. List: GET /v1/openline-configs/:lineId/quick-replies, field data.replies[].id

The request has no body.

Examples

curl — personal key

Terminal 
curl -X DELETE "https://vibecode.bitrix24.com/v1/openline-configs/1/quick-replies/7275" \
  -H "X-Api-Key: YOUR_API_KEY"

curl — OAuth application

Terminal 
curl -X DELETE "https://vibecode.bitrix24.com/v1/openline-configs/1/quick-replies/7275" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

JavaScript — personal key

javascript 
const res = await fetch(
  'https://vibecode.bitrix24.com/v1/openline-configs/1/quick-replies/7275',
  { method: 'DELETE', headers: { 'X-Api-Key': 'YOUR_API_KEY' } }
)
const { success, data } = await res.json()
console.log(data.deleted)

JavaScript — OAuth application

javascript 
const res = await fetch(
  'https://vibecode.bitrix24.com/v1/openline-configs/1/quick-replies/7275',
  {
    method: 'DELETE',
    headers: {
      'X-Api-Key': 'YOUR_APP_KEY',
      'Authorization': 'Bearer USER_SESSION_TOKEN',
    },
  }
)
const { success, data } = await res.json()
console.log(data.deleted)

Response fields

Field Type Description
Fieldsuccess Typeboolean Descriptiontrue on successful deletion
Fielddata.id Typeinteger DescriptionID of the deleted quick reply
Fielddata.deleted Typeboolean DescriptionAlways true

Response example

JSON 
{
  "success": true,
  "data": {
    "id": 7275,
    "deleted": true
  }
}

Error response example

404 — the lineId channel has no quick reply with this id:

JSON 
{
  "success": false,
  "error": {
    "code": "ENTITY_NOT_FOUND",
    "message": "Quick reply not found in this line"
  }
}

Errors

HTTP Code Description
HTTP400 CodeINVALID_PARAMS DescriptionlineId or id is not a positive integer
HTTP400 CodeINVALID_PARAMS DescriptionThe request body is not a JSON object
HTTP400 CodeINVALID_JSON_BODY DescriptionThe request body cannot be parsed as JSON
HTTP401 CodeMISSING_API_KEY DescriptionThe X-Api-Key header was not passed
HTTP401 CodeTOKEN_MISSING DescriptionThe key has no authorization on the Bitrix24 portal. For an application key, Authorization: Bearer was not passed
HTTP403 CodeSCOPE_DENIED DescriptionThe key lacks the imopenlines scope
HTTP403 CodeWRITE_BLOCKED_READONLY_KEY DescriptionThe key is in read-only mode
HTTP403 CodeBITRIX_ACCESS_DENIED DescriptionThe employee the call runs as cannot view this channel's quick replies
HTTP403 CodeBITRIX_ACCESS_DENIED DescriptionBitrix24 denied the employee permission to delete the reply
HTTP404 CodeENTITY_NOT_FOUND DescriptionMessage Quick reply not found in this line: the channel has no reply with this id. The same response is returned for the id of another channel's reply and for a repeated deletion
HTTP404 CodeENTITY_NOT_FOUND DescriptionMessage Record not found: there is no Open Channel with this lineId
HTTP422 CodeBITRIX_ERROR DescriptionBitrix24 returned an error. The text is in message
HTTP429 CodeRATE_LIMITED DescriptionThe method's own limit was exceeded. The overall platform ceiling is 120 requests per minute per portal and is split across platform replicas, so the code may arrive before the 120th request. The effective value is in the x-ratelimit-limit header
HTTP502 CodeOPENLINE_OPERATOR_FAILED DescriptionBitrix24 did not confirm the deletion or returned the channel's reply list in an unexpected shape. Check the list of quick replies before retrying
HTTP502 CodeBITRIX_UNAVAILABLE DescriptionThe Bitrix24 portal is unavailable
HTTP503 CodeBITRIX_TIMEOUT DescriptionBitrix24 did not respond in time, and the outcome is unknown. Check the list of quick replies before retrying

Full list of common API errors — Errors.

See also