> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trilly.chat/llms.txt
> Use this file to discover all available pages before exploring further.

# Annullamento Messaggi Pending

> Questo endpoint consente di annullare i messaggi in stato `PENDING` (non ancora inviati) associati al **cliente identificato tramite la propria API key**. Restituisce un elenco dei messaggi annullati, con l'ID e la data/ora in cui erano stati programmati per l'invio (`desired_date`). <Note>Se nessun messaggio è stato trovato in stato `PENDING`, il campo messages sarà una lista vuota.</Note> <Note>Il formato della `desired_date` è in **ISO_8601**.</Note> <Note>Se il campo `phones` **non viene incluso** nella richiesta, l'endpoint annullerà **tutti** i messaggi in stato `PENDING` per il cliente associato alla API key.</Note>



## OpenAPI

````yaml POST /api/messages/cancel/pending
openapi: 3.1.0
info:
  title: Trilly API
  description: Trilly APIs
  version: 1.0.0
servers:
  - url: https://backend.trilly.chat
security: []
paths:
  /api/messages/cancel/pending:
    post:
      summary: Annullamento dei messaggi in stato PENDING
      description: >-
        Questo endpoint consente di annullare i messaggi in stato `PENDING` (non
        ancora inviati) associati al **cliente identificato tramite la propria
        API key**. Restituisce un elenco dei messaggi annullati, con l'ID e la
        data/ora in cui erano stati programmati per l'invio (`desired_date`).
        <Note>Se nessun messaggio è stato trovato in stato `PENDING`, il campo
        messages sarà una lista vuota.</Note> <Note>Il formato della
        `desired_date` è in **ISO_8601**.</Note> <Note>Se il campo `phones`
        **non viene incluso** nella richiesta, l'endpoint annullerà **tutti** i
        messaggi in stato `PENDING` per il cliente associato alla API
        key.</Note>
      parameters:
        - name: api_key
          in: query
          required: true
          description: La API key del cliente.
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                phones:
                  type: array
                  description: >-
                    I numeri di telefono di cui si vogliono annullare i messaggi
                    in stato `PENDING`.
                  items:
                    type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Messaggio del risultato.
                  messages:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          description: ID del messaggio.
                        desired_date:
                          type: string
                          description: Data programmata per l'invio del messaggio.
                          format: date-time
              example:
                message: Messaggi in stato PENDING annullati con successo.
                messages:
                  - id: 25103
                    desired_date: '2025-04-23T13:59:11.000000Z'

````