Skip to main content
These are the limits on your integration’s traffic — how many requests your API key may make per minute, and how many async runs Edges processes at once. They are counted per workspace and they are separate from the per-identity action limits that protect LinkedIn accounts.
Not sure which limit stopped you? How Limits Work maps all five systems and tells you which ones you have to plan around.

Plan Tiers

Your rate limits are determined by your plan tier, which is based on your monthly credit allocation. You can see your current tier in your Workspace Settings.

API Rate Limits

Real-time Actions

The most important rate limits apply to real-time action execution via /v1/actions/{action-name}/run/live. These limits determine how many requests you can make per minute:
For async actions, different concurrent execution limits apply (see Concurrent Execution below).

What the rate alone allows

The figures below are throughput ceilings — what the per-minute rate permits if you sustained it around the clock and credits were not the binding constraint. In practice your credit balance is what bounds real volume; these numbers tell you only that the rate limit will not be what stops you. Example: a Silver or Gold plan permits 600 requests per minute, so roughly 36,000 per hour. Whether you can use that depends on your credits and, for LinkedIn work, on the per-identity action limits.

Identity Management

Rate limits for identity-related operations via /v1/identities (create, update, delete, retrieve):

What the rate alone allows

For identity operations (create, update, delete), sustained around the clock:

Workspace Info

Rate limits for workspace data retrieval via /v1/workspaces:

Run’s Routes Limits

All /runs/* routes share a single limit — status, outputs, inputs and the rest draw on the same per-minute budget, so polling several of them counts against one allowance.
Rate limits for polling run results via /v1/runs/{run_uid}/outputs. These limits support realistic polling patterns if you prefer polling over callbacks.
These limits are aligned with concurrent execution limits. For example, with a Silver/Gold plan (5 concurrent runs), you can poll all active runs every 10 seconds with comfortable headroom.

Capacity Examples

Implementation Details:
  • Rate limit type: Per-workspace, per-minute
  • Error response: Standard 429 with X-RateLimit-Type: /v1/runs/outputs
  • Headers include X-RateLimit-Remaining for visibility

Concurrent Execution

For async runs via /v1/actions/{action-name}/run/async, we limit the number of concurrent runs and batch processing: What this limits: Concurrent Runs cap how many runs Edges processes at once, not how many you can submit. You can submit as many runs as you need; extra runs are queued and start automatically when a slot is freed up. Batching: A batch holds up to 15 inputs for most actions. Batches within a run execute in parallel (up to “Max Batches per Run”), and multiple runs execute concurrently up to your plan’s “Max Concurrent Runs”.
Sensitive actions use much smaller batches on purpose. Connection requests, messages, InMail, profile visits and the searches are batched one or two inputs at a time, with a delay between batches, whatever your plan allows — pacing them protects the account, and no plan tier removes that.
For example: one run of 35 inputs → 3 batches (2×15 + 1x5) in parallel for that run. Example — ~1,800 inputs:

What concurrency alone allows

Throughput ceilings for async runs, before credits and per-identity action limits are taken into account: Example: a Platinum or Diamond plan runs 10 runs at once with 5 batches each, which is what determines how quickly a large job drains — not whether it is allowed to run.

Engagement Mode Rate Limits

For identities configured in engagement mode, a separate rate-limiting system applies. These limits are based on the number of active engagement identities in your workspace, not your credit-based plan tier.
Engagement mode identities are designed for LinkedIn automation workflows that don’t consume credits. Because of this, dedicated rate limits ensure fair usage across all users.
More about what’s an active engagement identity here

Rate Limits by Identity Count

As your engagement identity count grows, your rate limits automatically scale up to support higher volumes.

Understanding Engagement Limits

  • /v1/actions: Controls how many action requests you can make per minute/second
  • /v1/identities: Maximum operations per minute for identity management
  • /v1/workspaces: Maximum workspace info requests per minute
  • Max Concurrent Runs: Number of async runs that can execute in parallel
  • Daily API Limit: Total API calls allowed per day across all endpoints
  • Batches per Run: Maximum batches allowed per async run
If you have both engagement identities and a credit-based plan, the higher limit between the two systems applies for each endpoint.

Best Practices

Optimizing for Rate Limits

  1. Use Async Mode for High Volume: When processing large datasets, use async mode to benefit from concurrent execution limits rather than hitting real-time rate limits.
  2. Batch Your Requests: Group related operations together to minimize API calls.
  3. Implement Exponential Backoff: When you hit rate limits, wait before retrying with increasing delays.
  4. Monitor Your Usage: Track your API consumption to stay within limits.

Handling Rate Limit Errors

When you exceed rate limits, you’ll receive a 429 Too Many Requests response.
Retry-After is expressed in seconds. In the example above, "60" means wait 60 seconds before retrying. X-RateLimit-Reset is a Unix timestamp in seconds.

Limits that come from LinkedIn

A 429 can also originate from LinkedIn rather than from Edges. Those carry their own labels, and the wait is different for each.

Which limit was hit

Every label, its origin, and the right retry for each.

Plan-Specific Considerations

Trial and Bronze

  • Focus on development and testing
  • Use async mode for production workloads
  • Monitor usage closely to avoid interruptions

Silver, Gold, Platinum, and Diamond

  • Suitable for production workloads
  • Balance between real-time and async execution
  • Consider upgrading for higher volume needs

Titanium

  • Designed for enterprise-scale operations
  • Maximum concurrent execution capabilities
  • Contact support for custom limits if needed

Monitoring

Every response carries the rate limit headers described above — X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and X-RateLimit-Type. Reading X-RateLimit-Remaining as you go is cheaper than discovering the ceiling with a 429. If you consistently hit these limits, the fix is usually async mode rather than a bigger plan — it queues work for you instead of asking you to pace it. If it isn’t, talk to us about your volume.

How Limits Work

The five systems, and which ones apply to you.

Smart Limits

Per-identity quotas on LinkedIn actions.

Credit costs

What a run costs, as opposed to what it is allowed to do.