Rate limits

What this is: how much a token may call. When you need it: a batch job, a sync, a dashboard that polls.

curl

curl -si "$TASKSMATE_API_URL/v1/me" -H "Authorization: Bearer $TASKSMATE_TOKEN" | grep -i '^x-ratelimit'

Python

# The SDK waits out a 429 (Retry-After) and retries — up to max_retry_after seconds.
tm = TasksMate(max_retries=3, max_retry_after=60)

tm

tm tasks list   # retries a 429 the same way

Each token gets an allowance that refills every minute

The limits

Token	Requests per minute
tm_live_…	600
tm_test_…	60

The window is one fixed minute per token; every token request counts, refused ones included.

Headers

Every token-authenticated response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset (Unix seconds when the window ends).

Over the limit

429, type …:rate-limit: Too many requests with this access token; wait Retry-After seconds (X-RateLimit-* say where you stand). Back off until Retry-After, then resume. Spread work across the minute rather than bursting at its start.