Talon.One Collections API

Represents a collection of arbitrary values that you can use inside rules. For example, a list of SKUs. See the [docs](https://docs.talon.one/docs/product/campaigns/managing-collections).

GitHub OpenAPI

Operations 16

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/collections List account-level collections · List collections in account #
Ask an LLM
“What account-wide collections have I set up for use across Applications?”
“Can I search my account-level collections by name?”
Tell an agent
List all account-level collections.
Find account-level collections named {name}.
POST /v1/collections Create an account-level collection · Create account-level collection #
Ask an LLM
“How do I create a shared list of SKUs that every Application can use in its rules?”
“Can a new account-level collection be enabled only in certain Applications?”
Tell an agent
Create an account-level collection named {name}.
Create account collection {name} enabled in Applications {subscribedApplicationsIds}.
GET /v1/collections/{collectionId} Get an account-level collection · Get account-level collection #
Ask an LLM
“Which Applications is an account-level collection enabled in?”
“Can I look up a shared account collection by its ID?”
Tell an agent
Get account-level collection {collectionId}.
Show the settings of account collection {collectionId}.
PUT /v1/collections/{collectionId} Update an account-level collection · Update account-level collection #
Ask an LLM
“How do I turn an account-wide collection on or off for specific Applications?”
“Can I change the description of a shared account-level collection?”
Tell an agent
Enable account collection {collectionId} in Applications {subscribedApplicationsIds}.
Change the description of account-level collection {collectionId} to {description}.
DELETE /v1/collections/{collectionId} Delete an account-level collection · Delete account-level collection #
Ask an LLM
“How do I remove a shared collection from my whole account?”
“Can I delete an account-level collection I no longer use?”
Tell an agent destructive · confirm first
Delete account-level collection {collectionId}.
Remove shared account collection {collectionId} permanently.
GET /v1/collections/{collectionId}/items Get the items in a collection · Get collection items #
Ask an LLM
“What values are stored in a given collection?”
“Does the same call return items for both account and campaign collections?”
Tell an agent
Get the items in collection {collectionId}.
Show the first {pageSize} values stored in collection {collectionId}.
GET /v1/applications/{applicationId}/collections List campaign collections across an Application · List collections in Application #
Ask an LLM
“Which campaign-level collections exist across all campaigns in one Application?”
“Can I find a collection by name without knowing which campaign it belongs to?”
Tell an agent
List campaign-level collections from every campaign in Application {applicationId}.
Search Application {applicationId}'s campaign collections for name {name}.
GET /v1/applications/{applicationId}/campaigns/{campaignId}/collections List collections in a campaign · List collections in campaign #
Ask an LLM
“What collections does one specific campaign have?”
“Can I see how many collections a single campaign holds?”
Tell an agent
List the collections in campaign {campaignId} of Application {applicationId}.
Find collections named {name} inside campaign {campaignId} in Application {applicationId}.
POST /v1/applications/{applicationId}/campaigns/{campaignId}/collections Create a campaign-level collection · Create campaign-level collection #
Ask an LLM
“How do I add a collection of eligible SKUs to just one campaign?”
“Can I give a new campaign collection a description?”
Tell an agent
Create collection {name} in campaign {campaignId} of Application {applicationId}.
Add a campaign-level collection {name} described as {description} to campaign {campaignId} in Application {applicationId}.
GET /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId} Get a campaign-level collection · Get campaign-level collection #
Ask an LLM
“What are the details of a collection that belongs to one campaign?”
“Can I look up a campaign collection by ID?”
Tell an agent
Get collection {collectionId} in campaign {campaignId} of Application {applicationId}.
Show campaign-level collection {collectionId} from campaign {campaignId}, Application {applicationId}.
PUT /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId} Update a campaign collection's description · Update campaign-level collection's description #
Ask an LLM
“Can I edit the description of a collection inside a campaign?”
“What can I change on a campaign-level collection after creating it?”
Tell an agent
Set the description of collection {collectionId} in campaign {campaignId}, Application {applicationId}, to {description}.
Update campaign collection {collectionId} in campaign {campaignId} of Application {applicationId} with description {description}.
DELETE /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId} Delete a campaign-level collection · Delete campaign-level collection #
Ask an LLM
“How do I delete a collection that belongs to one campaign?”
“Can I remove a campaign collection without touching account-level ones?”
Tell an agent destructive · confirm first
Delete collection {collectionId} from campaign {campaignId} in Application {applicationId}.
Remove campaign-level collection {collectionId} of campaign {campaignId}, Application {applicationId}.
POST /v1/collections/{collectionId}/import Import items into an account-level collection · Import data into existing account-level collection #
Ask an LLM
“How do I fill a shared account collection from a CSV of values?”
“Does importing a CSV into an account collection replace what's already there?”
Tell an agent
Import {upFile} into account-level collection {collectionId}, replacing its contents.
Load the CSV {upFile} into shared account collection {collectionId}.
POST /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId}/import Import items into a campaign-level collection · Import data into existing campaign-level collection #
Ask an LLM
“How do I upload a CSV of values into a collection that belongs to a campaign?”
“Will uploading new items to a campaign's collection overwrite the old ones?”
Tell an agent
Import {upFile} into collection {collectionId} of campaign {campaignId} in Application {applicationId}.
Replace the items of campaign collection {collectionId} (campaign {campaignId}, Application {applicationId}) with CSV {upFile}.
GET /v1/collections/{collectionId}/export Export an account-level collection's items to CSV · Export account-level collection's items #
Ask an LLM
“Can I download the values of a shared account collection as a CSV?”
“How do I back up an account-level collection before re-importing it?”
Tell an agent
Export the items of account-level collection {collectionId} to CSV.
Download shared account collection {collectionId} as a file.
GET /v1/applications/{applicationId}/campaigns/{campaignId}/collections/{collectionId}/export Export a campaign-level collection's items to CSV · Export campaign-level collection's items #
Ask an LLM
“Can I download the items of a collection that belongs to one campaign?”
“What's in a campaign's collection, as a CSV file?”
Tell an agent
Export collection {collectionId} of campaign {campaignId} in Application {applicationId} to CSV.
Download campaign-level collection {collectionId} items from campaign {campaignId}, Application {applicationId}.

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/talon-one:talon-one-collections-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

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

OpenAPI Specification

talon-one-collections-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Management Collections API
  version: ''
  description: 'The Management API allows you to programmatically do what the Campaign Manager

    does.'
servers:
- url: https://yourbaseurl.talon.one
security:
- manager_auth: []
- management_key: []
tags:


# --- truncated at 32 KB (34 KB total) ---
# Full source: https://artifacts.apis.io/talon-one/openapi/talon-one-collections-api-openapi.yml