DocumentationDeveloper PortalAPI EndpointsProduct Updates
API Endpoints
Contact Us

List tags and tag folders

get
https://api.getblueshift.com/api/v1/tag_contexts/list

Use this endpoint to list all the tags and tag folders in your Blueshift account.

Query Params
string

Filter by resource type (e.g., Campaign, Segment, Template:EmailTemplate, SharedAsset, Syndication).

Note: Must exactly match the resource type. Not required when using resource_uuid since UUIDs are unique across all resource types.

uuid

Filter tags for a specific resource by its UUID. No need to specify resource_type when using UUID - UUIDs are unique across all resources.

Finding the UUID: • Campaign: https://app.getblueshift.com/dashboard#/app/campaigns/<CAMPAIGN_UUID>/details • Segment: https://app.getblueshift.com/dashboard#/app/segments/<SEGMENT_UUID>/edit/events • Template: https://app.getblueshift.com/dashboard#/app/templates/<TEMPLATE_UUID>/edit

Returns empty array [] if UUID doesn't exist or has no tags.

Responses

400

The request was invalid or cannot be otherwise served. An accompanying error message will explain further.

404

Resource not found. This can happen due to resource conflicts. Retry with exponential backoff. If the issue persists, contact Blueshift.

409

Conflict error, please retry. The request could not be completed due to a conflict with the current state of the target resource. Re-try with exponential backoff.

413

You can upload up to 50 users in an API call.

429

Rate limit exceeded. Too many requests. Contact us on [email protected] for recommended throughput.

500

Internal server error. Contact Blueshift for more information.

502

Service unavailable, please retry. Bad gateway. Retry with exponential backoff.

503

Service unavailable, please retry. Service unavailable. Retry with exponential backoff.

504

Service unavailable, please retry. Gateway timeout. Retry with exponential backoff.

Updated 2 days ago

Language
Credentials
Basic
base64
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 days ago