Kit

Kit Tags API

The Tags API from Kit — 6 operation(s) for tags.

Documentation GitHub OpenAPI

Business capability

Customer Segmentation Management BC-420.20

Operations 11

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

POST /v4/bulk/tags Create many tags at once · Bulk create tags #

Ask an LLM

“Can I create a whole batch of new tags in one request?”

“Is there a callback when a bulk tag creation job completes?”

Tell an agent

Bulk create these tags: {tags}.

Create the tags {tags} in bulk and notify {callback_url} when done.

DELETE /v4/bulk/tags/subscribers Remove tags from many subscribers at once · Bulk remove tags from subscribers #

Ask an LLM

“Can I strip tags from a large batch of subscribers in one request?”

“Is bulk untagging processed asynchronously?”

Tell an agent destructive · confirm first

Bulk remove tags from a batch of subscribers.

Untag many subscribers at once in a single bulk job.

POST /v4/bulk/tags/subscribers Tag many subscribers at once · Bulk tag subscribers #

Ask an LLM

“How do I apply tags to thousands of subscribers in one go?”

“Do subscribers need to exist before I bulk-tag them?”

Tell an agent

Apply these taggings in bulk: {taggings}.

Bulk tag subscribers with {taggings} and post the result to {callback_url}.

GET /v4/tags List tags · List tags #

Ask an LLM

“What tags have I created for organizing subscribers?”

“How do I find a tag's id to use in other requests?”

Tell an agent

List all my tags.

Show my tags, {per_page} per page.

POST /v4/tags Create a tag · Create a tag #

Ask an LLM

“How do I create a new tag for segmenting subscribers?”

“Can I add a single tag called something like Customer?”

Tell an agent

Create a tag named {name}.

Add a new subscriber tag called {name}.

PUT /v4/tags/{id} Rename a tag · Update tag name #

Ask an LLM

“Can I rename an existing tag without re-tagging everyone?”

“What's the way to fix a typo in a tag name?”

Tell an agent

Rename tag {id} to {name}.

Change the name of existing tag {id} to {name}.

DELETE /v4/tags/{tag_id}/subscribers Remove a tag from a subscriber by email · Remove tag from subscriber by email address #

Ask an LLM

“How do I untag a subscriber using their email address rather than their id?”

“Can I detach a tag from someone by email when I don't have their subscriber id?”

Tell an agent destructive · confirm first

Remove tag {tag_id} from a subscriber identified by email.

Untag the subscriber's email address from tag {tag_id}.

GET /v4/tags/{tag_id}/subscribers List subscribers with a tag · List subscribers for a tag #

Ask an LLM

“Who has a particular tag applied?”

“Can I see subscribers who were tagged after a certain date?”

Tell an agent

List subscribers tagged with {tag_id}.

Show subscribers who got tag {tag_id} after {tagged_after}.

POST /v4/tags/{tag_id}/subscribers Tag a subscriber by email address · Tag a subscriber by email address #

Ask an LLM

“How do I tag someone when I only know their email address?”

“Does a person have to be an existing subscriber before I tag their email?”

Tell an agent

Tag {email_address} with tag {tag_id}.

Apply tag {tag_id} to the subscriber whose email is {email_address}.

DELETE /v4/tags/{tag_id}/subscribers/{id} Remove a tag from a subscriber by id · Remove tag from subscriber #

Ask an LLM

“How do I take a tag off one subscriber when I have their subscriber id?”

“Can a tag be detached from a single subscriber id without affecting others?”

Tell an agent destructive · confirm first

Remove tag {tag_id} from subscriber id {id}.

Untag subscriber {id} from tag {tag_id} by their id.

POST /v4/tags/{tag_id}/subscribers/{id} Tag a subscriber by id · Tag a subscriber #

Ask an LLM

“Can I apply a tag to a subscriber using their subscriber id?”

“What's the request for tagging one known subscriber id?”

Tell an agent

Tag subscriber id {id} with tag {tag_id}.

Apply tag {tag_id} to subscriber {id} by their id.

Kit Tags API

Operations 11

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification