Talon.One

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).

Documentation 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}.

Talon.One Collections API

Operations 16

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification