Customer.io

Customer.io Assets API

Manage file assets such as images and PDFs and organize them into folders.

GitHub OpenAPI

Operations 10

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 /v1/assets List file assets · List file assets #
Ask an LLM
“How do I see all the images and PDFs uploaded to my asset library?”
“Can I list only the files directly inside one asset folder, not its subfolders?”
Tell an agent
List the file assets in asset folder {parent_folder_id}.
Show page {page} of my uploaded file assets.
POST /v1/assets/files Upload a file asset · Create a file asset #
Ask an LLM
“How do I upload an image or PDF to the asset library through the API?”
“What file types and sizes can I upload as an asset?”
Tell an agent
Upload {file} to the asset library as {name}.
Upload {file} into asset folder {parent_folder_id}.
GET /v1/assets/files/{id} Get a file asset · Get a file asset #
Ask an LLM
“How do I look up the details of one uploaded file asset?”
“Can I get the URL and size of a specific image in my asset library?”
Tell an agent
Get file asset {id}.
Show me the details of uploaded file {id}.
PUT /v1/assets/files/{id} Rename or move a file asset · Update a file asset #
Ask an LLM
“Can I rename an uploaded file asset without re-uploading it?”
“How do I move an image into a different asset folder?”
Tell an agent
Rename file asset {id} to {name}.
Move file asset {id} into asset folder {parent_folder_id}.
DELETE /v1/assets/files/{id} Delete a file asset · Delete a file asset #
Ask an LLM
“How do I remove an uploaded image from my asset library?”
“Can I delete a file asset that is still in use?”
Tell an agent destructive · confirm first
Delete file asset {id}.
Remove uploaded file {id} from the asset library.
GET /v1/assets/folders List asset folders · List folders #
Ask an LLM
“What folders exist in my file asset library?”
“Can I list just the subfolders directly under one asset folder?”
Tell an agent
List the asset folders under {parent_folder_id}.
Show all my asset library folders.
POST /v1/assets/folders Create an asset folder · Create a folder #
Ask an LLM
“How do I create a folder to organize my uploaded files?”
“Do asset folder names have to be unique?”
Tell an agent
Create an asset folder called {name}.
Create asset folder {name} inside folder {parent_folder_id}.
GET /v1/assets/folders/{id} Get an asset folder · Get a folder #
Ask an LLM
“How do I look up one folder in my asset library by ID?”
“Which parent does a given asset folder sit under?”
Tell an agent
Get asset folder {id}.
Show details for asset library folder {id}.
PUT /v1/assets/folders/{id} Rename or move an asset folder · Update a folder #
Ask an LLM
“Can I rename a folder in my asset library?”
“How do I nest one asset folder inside another?”
Tell an agent
Rename asset folder {id} to {name}.
Move asset folder {id} under folder {parent_folder_id}.
DELETE /v1/assets/folders/{id} Delete an empty asset folder · Delete a folder #
Ask an LLM
“How do I delete an empty folder from my asset library?”
“Why can't I delete an asset folder that still has files in it?”
Tell an agent destructive · confirm first
Delete asset folder {id}.
Remove the empty asset library folder {id}.

Documentation

📖
Documentation
https://docs.customer.io/integrations/api/app/
📖
Documentation
https://docs.customer.io/integrations/data-in/connections/http-api/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/openapi/customer-io-assets-api-openapi.yml

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/customer-io:customer-io-assets-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

customer-io-assets-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 1.0.0
  title: Customer.io App Assets API
  description: Our App API provides ways to trigger messages and retrieve information about people, campaigns, broadcasts, and more.
servers:
- url: https://api.customer.io
  description: The base URL for broadcasts, transactional messages, and data-retrieval APIs. These endpoints use bearer authorization, and require a [token that you generate in the UI](https://fly.customer.io/settings/api_credentials?keyType=app).
- url: https://api-eu.customer.io
  description: The base URL for broadcasts, transactional messages, and data-retrieval APIs (EU region). These endpoints use bearer authorization, and require a [token that you generate in the UI](https://fly.customer.io/settings/api_credentials?keyType=app).
tags:


# --- truncated at 32 KB (73 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/customer-io/refs/heads/main/openapi/customer-io-assets-api-openapi.yml