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

# Send Media

> Submit media message for delivery with immediate response. Media processing and delivery occurs in the background with real-time status tracking via the status endpoint.



## OpenAPI

````yaml https://cdn.conversoempire.world/converso-whatsapp-api-openapi-v2.3.json POST /message/sendMedia/{instance}
openapi: 3.0.3
info:
  title: Converso WhatsApp Api
  version: 2.3.0
servers:
  - url: https://whatsapp.api.conversoempire.world
security: []
paths:
  /message/sendMedia/{instance}:
    post:
      tags:
        - Message Controller
      summary: Send Media (Job-based Processing)
      description: >-
        Submit media message for delivery with immediate response. Media
        processing and delivery occurs in the background with real-time status
        tracking via the status endpoint.
      operationId: submitMedia
      parameters:
        - name: instance
          in: path
          required: true
          description: Name instance
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
                - number
                - mediatype
                - mimetype
                - caption
                - media
                - fileName
              properties:
                number:
                  type: string
                  description: Number to receive the message (with country code)
                mediatype:
                  type: string
                  description: Image, video or document
                mimetype:
                  type: string
                  description: image/png
                caption:
                  type: string
                  description: Teste de caption
                media:
                  type: string
                  description: Url or base64
                fileName:
                  type: string
                  description: Image.png
                delay:
                  type: integer
                  description: Presence time in milliseconds before sending message
                linkPreview:
                  type: boolean
                  description: >-
                    Shows a preview of the target website if there's a link
                    within the message
                mentionsEveryOne:
                  type: boolean
                  description: Mentioned everyone when the message send
                mentioned:
                  type: array
                  items:
                    type: string
                    enum:
                      - '{{remoteJID}}'
                  description: Numbers to mention
                quoted:
                  type: object
                  properties:
                    key:
                      type: object
                      properties:
                        id:
                          type: string
                          description: Quoted message ID
                    message:
                      type: object
                      properties:
                        conversation:
                          type: string
                          description: Quoted message content
      responses:
        '201':
          description: Accepted - Media delivery job queued for background processing
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaDeliveryResponse'
        '400':
          description: Bad Request - Invalid media type, URL, or size exceeds limits
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MediaJobErrorResponse'
        '401':
          description: Unauthorized - Invalid API key
        '404':
          description: Not Found - Instance not found
        '500':
          description: Internal Server Error
      deprecated: false
      security:
        - ApiKeyAuth: []
components:
  schemas:
    MediaDeliveryResponse:
      type: object
      description: Response for media job submission with real-time tracking capability
      properties:
        jobId:
          type: string
          description: >-
            Unique identifier for the media delivery job. Use this to retrieve
            real-time status and progress tracking.
          example: cuid_abc123xyz
        status:
          type: string
          enum:
            - queued
          description: >-
            Initial job status. Transitions through processing stages: queued →
            validating → processing → sending → completed or failed.
          example: queued
        createdAt:
          type: string
          format: date-time
          description: ISO 8601 timestamp when the job was created
          example: '2024-06-07T12:34:56.789Z'
      required:
        - jobId
        - status
        - createdAt
    MediaJobErrorResponse:
      type: object
      description: Error response returned when media submission validation fails
      properties:
        status:
          type: integer
          description: HTTP status code
          example: 400
        error:
          type: string
          description: Error type
          example: Bad Request
        message:
          type: string
          description: Detailed error message explaining the submission failure reason
          example: Media file size exceeds the maximum allowed limit of 100MB
        details:
          type: object
          description: >-
            Contextual information about the validation error including media
            specifications
          example:
            mediaType: image
            fileSize: 150MB
            maxAllowedSize: 100MB
      required:
        - status
        - error
        - message
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
      description: Your authorization key header

````