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

# Enviar lote de mensagens

> Aceita até 50 mensagens. Permissões de identidade/template e formatos de conteúdo são validados antes de enfileirar; uma negação rejeita toda a solicitação. Restrições de envio, cotas, supressão, renderização e falhas de armazenamento são retornadas por item, na ordem de entrada. queued significa aceito, não entregue. Use uma Idempotency-Key para todo o lote; repita itens rejeitados separadamente com uma nova chave.

<Info>
  Exige a ação IAM **`email:SendMessage`**. Veja [permissões de Email](/pt/email/permissions) for the full list, what each one covers, and an example policy.
</Info>


## OpenAPI

````yaml /pt/api-reference/specs/email.yaml post /v1/sent-messages/batch
openapi: 3.0.3
info:
  title: API Basaltic Email
  version: 1.0.0
  description: >
    API regional para enviar e receber emails, gerenciar identidades e registros
    DNS, templates, conjuntos de configurações, pools de IPs, regras de
    destinatário, conteúdo e anexos.


    As identidades devem ser verificadas em cada região. Crie uma identidade,
    publique seus dns_records e solicite a verificação. Apenas identidades
    verificadas podem enviar ou ativar o recebimento.


    Referências aceitam UUID, nome exclusivo na conta ou CRN do tipo esperado.
    Nomes são imutáveis. Referências malformadas ou de tipo/região incorretos
    retornam 400; inexistentes ou de outra conta retornam 404. Caminhos de
    recursos usam UUIDs. Filtros são exatos, limitados à conta e aplicados antes
    da paginação; referências inexistentes ou de outro escopo retornam
    resultados vazios.


    O conteúdo enviado e recebido expira após 30 dias. Os objetos dos anexos
    seguem o ciclo de vida do bucket independentemente. Use Telemetry para
    métricas agregadas e os endpoints de diagnóstico para eventos e registros
    DMARC.
  contact:
    name: Basaltic Support
    email: ping@basaltic.sh
  license:
    name: Proprietary
    url: https://basaltic.sh/terms
servers:
  - url: https://email.{region}.basaltic.sh
    description: Endpoint de API regional
    variables:
      region:
        default: sa-saopaulo-1
        description: Código de região
security:
  - BearerAuth: []
tags:
  - name: Email
    description: Envio de emails para clientes (regional).
paths:
  /v1/sent-messages/batch:
    post:
      tags:
        - Email
      summary: Enviar lote de mensagens
      description: >-
        Aceita até 50 mensagens. Permissões de identidade/template e formatos de
        conteúdo são validados antes de enfileirar; uma negação rejeita toda a
        solicitação. Restrições de envio, cotas, supressão, renderização e
        falhas de armazenamento são retornadas por item, na ordem de entrada.
        queued significa aceito, não entregue. Use uma Idempotency-Key para todo
        o lote; repita itens rejeitados separadamente com uma nova chave.
      operationId: sendMessageBatch
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchSendRequest'
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchSendResponse'
        '400':
          description: Solicitação inválida.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Autenticação necessária.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Permissão negada.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Recurso não encontrado.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Estado conflitante.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: Cota ou limite de taxa excedido.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Erro interno.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: Dependência indisponível.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    BatchSendRequest:
      type: object
      required:
        - messages
      properties:
        messages:
          type: array
          minItems: 1
          maxItems: 50
          items:
            $ref: '#/components/schemas/SendMessageRequest'
    BatchSendResponse:
      type: object
      required:
        - results
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/BatchSendResult'
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - request_id
          properties:
            code:
              type: string
              description: Código de erro identificando o tipo de erro
              example: INVALID_INPUT
            message:
              type: string
              description: Mensagem de erro legível pelo ser humano
              example: Invalid request parameters
            params:
              type: object
              additionalProperties: true
              description: >-
                Valores não sensíveis opcionais para interpolação de erros
                localizados, codificados por código de erro. Nunca presente para
                erros de servidor.
              example:
                instances: 2
                pools: 0
            request_id:
              type: string
              format: uuid
              description: Solicitar ID para depuração
              example: 550e8400-e29b-41d4-a716-446655440000
    SendMessageRequest:
      type: object
      required:
        - identity
        - from
        - to
        - content
      properties:
        attachments_bucket:
          type: string
          description: >-
            UUID, CRN ou nome do bucket para anexos embutidos no MIME bruto. Os
            objetos são gravados em email/{identity_id}/sent/{message_id}/.
            Entradas em attachments referenciam objetos existentes.
        attachments:
          type: array
          description: >-
            Objetos do bucket para anexar. Exige GetObject; a versão e o
            checksum são fixados na aceitação.
          items:
            $ref: '#/components/schemas/AttachmentInput'
        identity:
          type: string
          description: UUID, CRN ou nome exclusivo na conta.
        from:
          type: string
        to:
          type: array
          items:
            type: string
          minItems: 1
        subject:
          type: string
          description: >-
            Assunto para conteúdo text/HTML. Para raw ou template, o assunto vem
            desse conteúdo.
        configuration_set:
          type: string
          description: UUID, CRN ou nome exclusivo na conta.
        content:
          $ref: '#/components/schemas/SendContent'
    BatchSendResult:
      type: object
      required:
        - index
        - status
      properties:
        index:
          type: integer
        status:
          type: string
          enum:
            - queued
            - rejected
        message:
          $ref: '#/components/schemas/ResourceRef'
        error:
          $ref: '#/components/schemas/error'
    AttachmentInput:
      type: object
      required:
        - bucket
        - key
        - name
      properties:
        bucket:
          type: string
          description: Nome, UUID ou CRN do bucket na mesma conta e região.
        key:
          type: string
          minLength: 1
        version_id:
          type: string
          description: Token opaco opcional de versão do objeto Storage.
        name:
          type: string
          minLength: 1
          description: Nome do arquivo anexo.
        content_type:
          type: string
          description: Tipo MIME; usa o tipo de conteúdo do objeto por padrão.
    SendContent:
      type: object
      properties:
        text:
          type: string
        html:
          type: string
        raw:
          type: string
          description: >-
            Mensagem RFC 5322 completa. O cabeçalho From deve pertencer ao
            domínio da identidade autorizada.
        template:
          type: string
          description: >-
            UUID, CRN ou nome do template; exige email:SendTemplatedMessage
            nesse template.
        template_data:
          type: object
          additionalProperties:
            type: string
      description: >-
        Exatamente um modo de conteúdo: text e/ou html; raw; ou template com
        template_data opcional. Texto nunca é interpretado como HTML por
        inferência.
      oneOf:
        - anyOf:
            - required:
                - text
            - required:
                - html
          not:
            anyOf:
              - required:
                  - raw
              - required:
                  - template
        - required:
            - raw
          not:
            anyOf:
              - required:
                  - text
              - required:
                  - html
              - required:
                  - template
        - required:
            - template
          not:
            anyOf:
              - required:
                  - text
              - required:
                  - html
              - required:
                  - raw
    ResourceRef:
      type: object
      required:
        - id
        - crn
      properties:
        id:
          type: string
          format: uuid
          example: 288aa1e9-bbf5-5584-bce9-6a688f06d8a1
        crn:
          type: string
          example: crn:catalog::platform:country/288aa1e9-bbf5-5584-bce9-6a688f06d8a1
        name:
          type: string
          description: >-
            Rótulo no momento da resposta: o nome do recurso, quando houver, ou
            seu rótulo legível (número de fatura, nome de exibição da conta).
            Ausente quando o destino não existe mais. Não é uma chave de
            consulta.
          example: Brazil
    error:
      type: object
      required:
        - code
        - message
        - request_id
      properties:
        code:
          type: string
          description: Código de erro identificando o tipo de erro
          example: INVALID_INPUT
        message:
          type: string
          description: Mensagem de erro legível pelo ser humano
          example: Invalid request parameters
        params:
          type: object
          additionalProperties: true
          description: >-
            Valores não sensíveis opcionais para interpolação de erros
            localizados, codificados por código de erro. Nunca presente para
            erros de servidor.
          example:
            instances: 2
            pools: 0
        request_id:
          type: string
          format: uuid
          description: Solicitar ID para depuração
          example: 550e8400-e29b-41d4-a716-446655440000
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >+
        Um token bearer OAuth 2.0, enviado como `Authorization: Bearer <token>`.
        Esta é a forma recomendada de autenticação.


        Obtenha o token trocando o par de chaves de acesso de uma conta de
        serviço em `POST /v1/oauth/token` com `grant_type=client_credentials`.
        Esse é o fluxo padrão de credenciais de cliente; bibliotecas compatíveis
        com OAuth podem obter e renovar o token para você.


        ```

        curl -s -u "$KEY_ID:$SECRET" -d grant_type=client_credentials \
          https://iam.basaltic.sh/v1/oauth/token
        ```


        Os tokens duram uma hora por padrão. O mesmo par de chaves de acesso
        também serve como credencial AWS SigV4 para o endpoint de objetos
        compatível com S3, que aceita somente esse método de autenticação.


````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.