FAQ / Troubleshooting

Why do I get 401 Unauthorized even though my credentials are valid?

Confirm you’re sending the API key in the X-API-Key header. See Authentication.

Why did my bulk-import request get rejected with 429?

You exceeded your account’s per-second or per-minute rate limit for POST /v1/links/bulk. Check the X-RateLimit-Remaining-Second and X-RateLimit-Remaining-Minute headers on prior responses to see how much headroom you had, and space out your requests. See Limits.

What’s the difference between /v1/links/bulk and /public/links/bulk?

They’re the same operation under two path prefixes — /public/links/bulk is a legacy alias kept for backward compatibility. New integrations should use the /v1/ paths. See API Reference.