Omnisend

Omnisend Images API

The Images API from Omnisend — 5 operation(s) for images. Version 2026-03-15, harvested from Omnisend's published contract.

Documentation GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /images List images in the library · List images #

Ask an LLM

“Which images are in my brand's image library?”

“Can I search my uploaded images by name?”

Tell an agent

List images whose name contains {nameContains}.

List my library images sorted by {sort}.

POST /images Add an image from a URL · Upload image by URL #

Ask an LLM

“Can I add an image to my library from a public URL?”

“What name is used if I import an image by URL without naming it?”

Tell an agent

Upload the image at {url} and name it {name}.

Import the image from URL {url}.

DELETE /images/{id} Delete an image · Delete image #

Ask an LLM

“Can I delete an image from my library?”

“Is there a way to remove an image I uploaded by mistake?”

Tell an agent destructive · confirm first

Delete image {id}.

Remove image {id} from my library.

GET /images/{id} Get one image · Get image #

Ask an LLM

“Can I get the details of a single library image by its ID?”

“What does the image library store for one particular image?”

Tell an agent

Get image {id}.

Show the details of library image {id}.

POST /images/upload Upload an image file · Upload image file #

Ask an LLM

“How do I upload an image file directly from my computer?”

“Which image formats and file sizes can I upload as a file?”

Tell an agent

Upload the image file {file} named {name}.

Upload local file {file} to my image library.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/omnisend:omnisend-images-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  contact: {}
  description: External API for image retrieval, upload, and deletion.
  title: Images API
  version: '5.0'
servers:
- url: https://api.omnisend.com/api
tags:
- name: Images
paths:
  /images:
    get:
      description: 'With this endpoint you can get a paginated list of images for a brand.


        **Sorting:**

        Supported sort fields: `createdAt` (default), `name`

        Supported directions: `asc`, `desc` (default)


        **Filtering:**

        Use `nameContains` to filter images by name (case-insensitive, partial match)


        **Pagination:**

        This endpoint uses cursor-based pagination for efficient traversal of large datasets.

        - Use the `cursors.after` value from the response to get the next page

        - Use the `cursors.before` value from the response to get the previous page

        - The `hasMore` field indicates if more results are available

        - Do not use both `after` and `before` parameters simultaneously

        - Maximum page size is 250 items (default 100)


        **Scopes:**

        `images.read`


        **Rate Limiting:**

        This endpoint is rate limited to 400 requests per minute.'
      parameters:
      - $ref: '#/components/parameters/APIVersionHeader'
      - description: Number of images per page (1-250)
        in: query
        name: limit
        schema:
          type: integer
          minimum: 1
          maximum: 250
          default: 100
      - description: Cursor for next page (base64-encoded, from previous response)
        in: query
        name: after
        schema:
          type: string
      - description: Cursor for previous page (base64-encoded, from previous response)
        in: query
        name: before
        schema:
          type: string
      - description: Field to sort by
        in: query
        name: sort
        schema:
          type: string
          enum:
          - createdAt
          - name
          default: createdAt
      - description: Sort order
        in: query
        name: direction
        schema:
          type: string
          enum:
          - asc
          - desc
          default: desc
      - description: Filter images by name (partial match, case-insensitive, max 200 characters)
        in: query
        name: nameContains
        schema:
          type: string
          maxLength: 200
      responses:
        '200':
          description: List of images
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListResponse'
        '400':
          description: Request contains invalid or missing fields
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblem'
        '401':
          description: Authentication is missing or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '403':
          description: Insufficient permissions for this operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '410':
          description: API version has been retired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '500':
          description: Unexpected error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
      - Bearer:
        - images.read
      - ApiKeyAuth: []
      summary: List images
      tags:
      - Images
      operationId: getImages
      x-operation-id-source: derived
    post:
      description: 'With this endpoint you can upload an image from a publicly accessible URL.

        If the name is not provided, the filename will be extracted from the URL.


        **Scopes:**

        `images.write`


        **Rate Limiting:**

        This endpoint is rate limited to 400 requests per minute.'
      parameters:
      - $ref: '#/components/parameters/APIVersionHeader'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UploadURLRequest'
        description: Image URL and optional name
        required: true
      responses:
        '201':
          description: Image uploaded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Image'
        '400':
          description: Request contains invalid or missing fields
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblem'
        '401':
          description: Authentication is missing or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '403':
          description: Insufficient permissions for this operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '410':
          description: API version has been retired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '500':
          description: Unexpected error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
      - Bearer:
        - images.write
      - ApiKeyAuth: []
      summary: Upload image by URL
      tags:
      - Images
      operationId: postImages
      x-operation-id-source: derived
  /images/{id}:
    delete:
      description: 'With this endpoint you can delete an image by ID.


        **Scopes:**

        `images.write`


        **Rate Limiting:**

        This endpoint is rate limited to 400 requests per minute.'
      parameters:
      - $ref: '#/components/parameters/APIVersionHeader'
      - description: Image ID
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Image deleted
        '400':
          description: Request contains invalid or missing fields
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblem'
        '401':
          description: Authentication is missing or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '403':
          description: Insufficient permissions for this operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '410':
          description: API version has been retired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '500':
          description: Unexpected error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
      - Bearer:
        - images.write
      - ApiKeyAuth: []
      summary: Delete image
      tags:
      - Images
      operationId: deleteImagesById
      x-operation-id-source: derived
    get:
      description: 'With this endpoint you can get a single image by ID.


        **Scopes:**

        `images.read`


        **Rate Limiting:**

        This endpoint is rate limited to 400 requests per minute.'
      parameters:
      - $ref: '#/components/parameters/APIVersionHeader'
      - description: Image ID
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Image retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Image'
        '400':
          description: Request contains invalid or missing fields
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblem'
        '401':
          description: Authentication is missing or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '403':
          description: Insufficient permissions for this operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '410':
          description: API version has been retired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '500':
          description: Unexpected error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
      - Bearer:
        - images.read
      - ApiKeyAuth: []
      summary: Get image
      tags:
      - Images
      operationId: getImagesById
      x-operation-id-source: derived
  /images/upload:
    post:
      description: 'With this endpoint you can upload an image file directly from your computer.


        **File Requirements:**

        - Supported formats: JPEG, PNG, GIF, WebP

        - Maximum file size: 5MB


        **Scopes:**

        `images.write`


        **Rate Limiting:**

        This endpoint is rate limited to 400 requests per minute.'
      parameters:
      - $ref: '#/components/parameters/APIVersionHeader'
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  description: Image file to upload (JPEG, PNG, GIF, or WebP, max 5MB)
                  type: string
                  format: binary
                name:
                  description: Custom name for the image. Defaults to the filename if not provided
                  type: string
              required:
              - file
        required: true
      responses:
        '201':
          description: Image uploaded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Image'
        '400':
          description: Request contains invalid or missing fields
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationProblem'
        '401':
          description: Authentication is missing or invalid
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '403':
          description: Insufficient permissions for this operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '410':
          description: API version has been retired
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
        '500':
          description: Unexpected error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Problem'
      security:
      - Bearer:
        - images.write
      - ApiKeyAuth: []
      summary: Upload image file
      tags:
      - Images
      operationId: postImagesUpload
      x-operation-id-source: derived
components:
  schemas:
    Image:
      description: Image is an external image resource.
      properties:
        createdAt:
          description: Image creation timestamp.
          example: '2026-01-15T10:30:00Z'
          type: string
        height:
          description: Image height in pixels.
          example: 1080
          type: integer
        id:
          description: Unique image identifier.
          example: 507f1f77bcf86cd799439011
          type: string
        name:
          description: Image name.
          example: my-image
          type: string
        size:
          description: Image size in bytes.
          example: 102400
          type: integer
        type:
          description: MIME type of the image.
          example: image/jpeg
          type: string
        url:
          description: Public CDN URL of the image.
          example: https://cdn.example.com/image.jpg
          type: string
        width:
          description: Image width in pixels.
          example: 1920
          type: integer
      type: object
    PagingResponse:
      description: Cursor-based pagination metadata
      properties:
        cursors:
          allOf:
          - $ref: '#/components/schemas/CursorsResponse'
          description: Cursor values for navigating between pages
        hasMore:
          description: Whether there are more items available beyond the current page
          example: true
          type: boolean
        limit:
          description: Maximum number of items returned per page
          example: 50
          type: integer
      type: object
    Problem:
      description: Standard error response returned by all API endpoints on failure.
      properties:
        detail:
          description: Human-readable explanation of this specific error occurrence
          example: A human-readable explanation of the error.
          type: string
        instance:
          description: Request trace identifier for support and debugging
          example: urn:omnisend:request:00000000-0000-0000-0000-000000000001
          type: string
        status:
          description: HTTP status code
          example: 0
          type: integer
        title:
          description: Short description of the error type
          example: Problem
          type: string
        type:
          description: URI that identifies the error type
          example: https://problems.omnisend.com/problem
          type: string
      type: object
    ListResponse:
      description: ListResponse is the paginated image list response.
      properties:
        images:
          description: Returned images.
          items:
            $ref: '#/components/schemas/Image'
          type: array
        paging:
          allOf:
          - $ref: '#/components/schemas/PagingResponse'
          description: Cursor pagination metadata.
      type: object
    ValidationProblem:
      description: Error response returned when the request contains invalid input. The errors array lists every field that failed validation.
      properties:
        detail:
          description: Human-readable explanation of this specific error occurrence
          example: A human-readable explanation of the error.
          type: string
        errors:
          description: List of fields that failed validation
          items:
            $ref: '#/components/schemas/FieldError'
          type: array
        instance:
          description: Request trace identifier for support and debugging
          example: urn:omnisend:request:00000000-0000-0000-0000-000000000001
          type: string
        status:
          description: HTTP status code
          example: 0
          type: integer
        title:
          description: Short description of the error type
          example: Problem
          type: string
        type:
          description: URI that identifies the error type
          example: https://problems.omnisend.com/problem
          type: string
      type: object
    UploadURLRequest:
      description: UploadURLRequest contains payload for uploading an image by URL.
      properties:
        name:
          description: Custom name for the image. If not provided, the filename will be extracted from the URL
          example: my-image
          type: string
        url:
          description: URL of the image to upload. Must be publicly accessible (HTTPS, PNG, JPEG, GIF, or WebP, max 5MB)
          example: https://example.com/image.jpg
          type: string
      required:
      - url
      type: object
    FieldError:
      description: A single field validation failure within a validation error response.
      properties:
        code:
          description: Error code indicating the type of failure
          example: invalid_format
          type: string
        field:
          description: Dot-separated path to the field that failed validation
          example: content.email.subject
          type: string
        message:
          description: Human-readable explanation of what is wrong with the field value
          example: Must be a valid email address
          type: string
      type: object
    CursorsResponse:
      description: Cursor pointers for paginating forward and backward through results
      properties:
        after:
          description: Opaque cursor for fetching the next page of results
          example: eyJpZCI6ImNhbXAtNDU2In0
          type:
          - string
          - 'null'
        before:
          description: Opaque cursor for fetching the previous page of results
          example: eyJpZCI6ImNhbXAtMTIzIn0
          type:
          - string
          - 'null'
      type: object
  parameters:
    APIVersionHeader:
      description: API version that specifies the response format and behaviour
      in: header
      name: Omnisend-Version
      required: true
      schema:
        type: string
        default: '2026-03-15'
  securitySchemes:
    ApiKeyAuth:
      in: header
      name: Authorization
      type: apiKey
    Bearer:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://app.omnisend.com/oauth2/token
          scopes:
            images.read: Allows reading images
            images.write: Allows uploading and deleting images

Omnisend Images API

Operations 5

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification