Rate Limits

Pipedream rate limits

The following rate limits apply to the Connect API:

Name	Endpoint	Request Limit	Scope
Create OAuth Token	`POST /v1/oauth/token`	3,500 per 5 minutes	Per OAuth client
List and Retrieve Accounts	`GET /accounts`, `GET /accounts/{account_id}`, `GET /apps/{app_id}/accounts`	2,000 per 5 minutes	Per project
List and Retrieve Components	`GET /components/`, `GET /actions/`, `GET /triggers/`, `GET /deployed-triggers/`	3,000 per 5 minutes	Per project
Reload Props, Deploy Trigger, and Manage Deployed Triggers	`POST /{components,actions,triggers}/props`, `POST /triggers/deploy`, `PUT \| POST \| DELETE /deployed-triggers/*`	2,000 per 5 minutes	Per project
Project management	All of the endpoints above, plus project management endpoints such as users, accounts, deployed triggers, OAuth clients, app overrides, and webhooks	5,000 per 5 minutes, combined	Per project

To get the connected accounts for one user, use List user accounts (GET /users/{external_user_id}/accounts). It is the fastest way to retrieve account details and credentials. Access tokens from POST /v1/oauth/token are valid for multiple requests. Reuse a token until it expires. Do not request a new token for each API call. Pipedream also applies per-IP rate limits to all traffic to protect the platform. Need higher limits? Contact our support team to discuss your requirements.

Rate limit responses

When you exceed a limit, the API returns HTTP 429 Too Many Requests. Responses from the per-project and per-client limits above include these headers:

Header	Description
`Retry-After`	Seconds until the current window resets
`X-RateLimit-Limit`	Maximum requests allowed in the window
`X-RateLimit-Remaining`	Requests remaining in the window (always `0` on a `429`)
`X-RateLimit-Reset`	Unix timestamp, in seconds, when the window resets

Wait until the window resets before you retry. Use exponential backoff for retries.

Custom rate limits

You can set custom rate limits for your users to control their usage of the Connect API and prevent runaway requests or abuse.

Create rate limit

Create a rate limit by specifying a time window and maximum requests allowed within that window. The API returns a rate_limit_token that you include in subsequent Connect API requests.

POST /rate_limits

Parameters

Parameter	Type	Description
`window_size_seconds`	integer	Time window duration in seconds
`requests_per_window`	integer	Maximum requests allowed per window

Example request

# First, obtain an OAuth access token
curl -X POST https://api.pipedream.com/v1/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "{oauth_client_id}",
    "client_secret": "{oauth_client_secret}"
  }'

# Create the rate limit
curl -X POST https://api.pipedream.com/v1/connect/rate_limits \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer {access_token}" \
  -d '{
    "window_size_seconds": 10,
    "requests_per_window": 1000
  }'

Response

{
  "token": "CiKpqRdTmNwLfhzSvYxBjAkMnVbXuQrWeZyHgPtJsDcEvFpLnE"
}

Using rate limit tokens

Include the rate_limit_token in the x-pd-rate-limit header for all Connect API requests:

curl -X POST "https://api.pipedream.com/v1/connect/{project_id}/actions/run" \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -H "x-pd-rate-limit: {rate_limit_token}" \
  -d '{
    "external_user_id": "user123",
    "id": "gitlab-list-commits",
    "configured_props": {
      "gitlab": {
        "authProvisionId": "apn_kVh9AoD"
      },
      "projectId": 45672541,
      "refName": "main"
    }
  }'

All requests that send the same rate_limit_token share one limit. To give each of your users a separate limit, create a token for each user. When a request exceeds a custom rate limit, the API returns HTTP 429 Too Many Requests with an x-pd-rate-limit-reset-in header. The header gives the number of seconds until the window resets.

Tokens

Apps

Accounts

External Users

Actions

Triggers

Deployed Triggers

Components

OAuth Clients

App Overrides

Projects

Project Webhooks

Connect Usage

File Stash

Pipedream rate limits

Rate limit responses

Custom rate limits

Create rate limit

Parameters

Example request

Response

Using rate limit tokens

​Pipedream rate limits

​Rate limit responses

​Custom rate limits

​Create rate limit

​Parameters

​Example request

​Response

​Using rate limit tokens

Pipedream rate limits

Rate limit responses

Custom rate limits

Create rate limit

Parameters

Example request

Response

Using rate limit tokens