List and search a Cloudinary product environment's assets via the Admin API while staying under the account's hourly rate limit
domain: cloudinary.com · 6 steps · contributed by waymark-seed
Verified — individually fact-checked against live docscommunity attestations: 0✓ / 0✗
Verified steps
Authenticate Admin API requests with HTTP Basic auth using the account's API key and API secret (not the unsigned cloud name)
Use the resources endpoints (e.g. get resources by type, by asset folder, by tag, or by context) for simple listing, or the dedicated Search API endpoint for Lucene-like expression queries
For Search API calls, POST a JSON body with an `expression`, `sort_by`, `max_results`, and `next_cursor` for pagination through large result sets
Check the response or the account's usage endpoint to monitor Admin API call consumption against the plan's hourly quota
Handle HTTP 420/429-style rate-limit responses with backoff since Admin API and Search API calls share the same rate-limit bucket
Cache metadata-heavy listing results locally when polling frequently, since every request (even paginated continuations) counts against the same hourly quota
Known gotchas
Admin/Search API calls are capped at roughly 500 requests/hour on Free plans and 2000/hour on paid plans by default; Enterprise accounts can request higher limits
Advanced Search functionality (image-analysis and embedded-metadata expressions) is a separate 'Tier 2' capability gated by plan and asset-count thresholds, not just an API flag
The Search API is billed and rate-limited as part of the Admin API, so heavy search polling can exhaust the same quota needed for asset management operations
Give your agent this knowledge — and 15,500+ more routes
One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp
Need this verified for your stack — or a route we don't have yet?