Skip to content

List Warmup Tags

The workspace's warmup tags.

GEThttps://api.foxreach.io/api/v1/warmup/tags

Requires an API key with the read scope.

Tags group accounts in the warmup pool. They can be created and assigned in the dashboard; there is no write endpoint for them. Use a tag id with the tag filter on Get Warmup Pool.

Response#

dataarray

Tags, sorted by name.

Show data
idstring
Tag identifier.
namestring
Tag name.
colorstring
Tag color.

Errors#

StatusDescription
401Missing, invalid, revoked or expired API key
403API key does not have the required scope: read

Rate Limit#

  • 100 requests per minute, per API key. Fixed 60-second window.
  • Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset (unix epoch seconds).
  • A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns (Retry-After, exponential backoff, monitoring X-RateLimit-Remaining), see Rate Limiting.

Was this page helpful?
View as MarkdownLast updated November 2, 2026