Endpoints

Getting Started

Installation

Browser Extension

Setup

Inspect Traffic

Create Rule while inspecting Traffic

Import/ Export Network Sessions

HTTP Rules (Modify Traffic)

Overview

Request Modification — Redirect URL (Map Local, Map Remote)

Request Modification — Replace Strings (Switch Hosts, API Endpoints)

Request Modification — Modify Headers

Request Modification — Modify Request Body

Response Modification — Modify Response Body

Request Modification — Modify Query Params

Request Modification — Modify User Agents

Request Modification — Delay Request

Request Modification — Map Local

Request Modification — Map Remote

Response Modification — Modify DOM/Inject scripts

Response Modification — Cancel Rule

Predefined Functions

Organizing Rule — Grouping

Organizing Rule — Import/Export Rules from File

Organizing Rule — Pause/Resume Requestly

Organizing Rule — Rule Operators

Organizing Rule — Advance Targeting

Organizing Rule — Sharing Rules

Organizing Rule — Pinning Rules

GraphQL - Modify Request & Response

Import / Export — Charles Proxy Rules

Test Rules — Test URL Condition

Test Rules — Test this Rule

Session Book

Mock Server

API Client

Replay request from History

File Server

Workspace

How to get started with Shared Workspace

User Roles

Managing Workspace

Public API

📓

Introduction to Requestly API

📓

Endpoints — Rules API

Endpoints — Groups API

Guides

Inspect traffic and apply modifications from Chrome DevTools using Requestly

Know if a rule executed on the page

Debug HTTPs requests in iOS Simulator

Modifying response asynchronously

TroubleShooting

System Wide Proxy Not Working (macOS)

Troubleshooting Safari

Disable System Wide Proxy (MacOS)

Rules Not Working

Troubleshooting: Untrusted SSL certificate

Subscription & Billing

Billing Team

Getting Started

Introduction

Quick Start Guides — Make API Call

Quick Start Guides — Record new Session

Quick Start Guides — Create New Mock API

Downloads

Change Logs

Quick Start Guides — Create First Rule

Installation

Setup

Inspect Traffic

Create Rule while inspecting Traffic

Import/ Export Network Sessions

API Client

Overview

Make an API Request

Replay request from History

Import from cURL

HTTP Rules (Modify Traffic)

Overview

Request Modification — Redirect URL (Map Local, Map Remote)

Request Modification — Replace Strings (Switch Hosts, API Endpoints)

Request Modification — Modify Headers

Request Modification — Modify Request Body

Response Modification — Modify Response Body

Request Modification — Modify Query Params

Response Modification — Modify DOM/Inject scripts

Request Modification — Modify User Agents

Request Modification — Delay Request

Response Modification — Cancel Rule

Organizing Rule — Grouping

Organizing Rule — Import/Export Rules from File

Organizing Rule — Pause/Resume Requestly

Organizing Rule — Rule Operators

Organizing Rule — Advance Targeting

Organizing Rule — Sharing Rules

Request Modification — Map Local

Request Modification — Map Remote

Organizing Rule — Pinning Rules

GraphQL - Modify Request & Response

Import / Export — Charles Proxy Rules

Test Rules — Test URL Condition

Predefined Functions

Test Rules — Test this Rule

Mock Server

File Server

Workspace

How to get started with Shared Workspace

Public API

Endpoints — Groups API

📓

Endpoints — Rules API

📓

Schema — Rules

📓

Introduction to Requestly API

Guides

Inspect traffic and apply modifications from Chrome DevTools using Requestly

Know if a rule executed on the page

Debug HTTPs requests in iOS Simulator

Modifying response asynchronously

Session Book

Subscription & Billing

Billing Team

TroubleShooting

System Wide Proxy Not Working (macOS)

Troubleshooting Safari

Disable System Wide Proxy (MacOS)

Rules Not Working

Troubleshooting: Untrusted SSL certificate

Authentication

To authenticate with the API, use the custom header x-api-key with your provided API key.

Example:


curl -H "x-api-key: YOUR_API_KEY" https://api2.requestly.io/v1/rules

🎁

Requestly API is currently in BETA. Fill this form to get your API key today.

The current APIs give all the basic crud capabilities for rules and groups. In case you want to quickly try these out on this playground https://requestly.readme.io/

Retrieve Groups

Get All Groups

Endpoint: GET /groups

CURL Example:


curl -H "x-api-key: YOUR_API_KEY" https://api2.requestly.io/v1/groups

Sample Response:


{
  "success": true,
  "data": [
        {
            "createdBy": "Gw9geGxr4aWejyB1erPKMnyFNNZW",
            "creationDate": 1707893324459,
            "currentOwner": "Gw9geGxr4aWejyB1erPKMnyFNNZW",
            "description": "",
            "groupId": "",
            "id": "Cancel_jcgzx",
            "isSample": false,
            "lastModifiedBy": "Gw9geGxr4aWejyB1erPKMnyFNNZW",
            "modificationDate": 1707893326371,
            "name": "cancel-1707893324464",
            "objectType": "rule",
            "pairs": [
                {
                    "id": "vr1e2",
                    "source": {
                        "key": "Url",
                        "operator": "Contains",
                        "value": "sdfa"
                    }
                }
            ],
            "ruleType": "Cancel",
            "status": "Active"
        },
				// other groups
    ]
}

Get a Specific Group

Endpoint: GET /groups/:id

CURL Example:


curl -H "x-api-key: YOUR_API_KEY" https://api2.requestly.io/v1/groups/Group_1a2b3c

Sample Response:


{
  "success": true,
  "data": {
        "id": "Group_4bfu8",
        "creationDate": 1707893421467,
        "modificationDate": 1707894488025,
        "createdBy": "Gw9geGxr4aWejyB1erPKMnyFNNZW",
        "lastModifiedBy": "Gw9geGxr4aWejyB1erPKMnyFNNZW",
        "name": "now this is active",
        "objectType": "group",
        "status": "Active",
        "isFavourite": false
    }
}

Create a Group

Endpoint: POST /groups

CURL Example:


curl -X POST -H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" -d '{
  "name": "New Awesome Group",
  "status": "Active"
}' https://api2.requestly.io/v1/groups

Sample Response:


{
  "success": true,
  "data": {
        "id": "Group_08j61",
        "creationDate": 1707894094078,
        "modificationDate": 1707894094078,
        "createdBy": "Gw9geGxr4aWejyB1erPKMnyFNNZW",
        "lastModifiedBy": "Gw9geGxr4aWejyB1erPKMnyFNNZW",
        "name": "New Awesome Group",
        "objectType": "group",
        "status": "Active",
        "isFavourite": false,
        "currentOwnerId": "Gw9geGxr4aWejyB1erPKMnyFNNZW"
    }}

Update a Group

Endpoint: PUT /groups/:id

CURL Example:


curl -X PUT -H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" -d '{
  "name": "Updated Group Name",
  "status": "Inactive"
}' https://api2.requestly.io/v1/groups/Group_1a2b3c

Sample Response:


{
  "success": true,
  "data": {
        "id": "Group_1a2b3c",
        "creationDate": 1707893421467,
        "modificationDate": 1707894488025,
        "createdBy": "Gw9geGxr4aWejyB1erPKMnyFNNZW",
        "lastModifiedBy": "Gw9geGxr4aWejyB1erPKMnyFNNZW",
        "name": "Updated Group Name",
        "objectType": "group",
        "status": "Inactive",
        "isFavourite": false
    }
}

Delete a Group

Endpoint: DELETE /groups/:id

CURL Example:


curl -X DELETE -H "x-api-key: YOUR_API_KEY" https://api2.requestly.io/v1/groups/Group_1a2b3c

Sample Response:


{
  "success": true,
  "message": "Group successfully deleted."
}

Possible Errors

Group not found: The specified group does not exist.

Unauthorized action: You do not have access to the specified group.

Invalid Group Id: The provided group ID is invalid.

Invalid Group Payload: The entire group payload is invalid.

Group Name Required: A group name is required.

Each error returns a response in the format:


{
  "success": false,
  "message": "Error message here."
}

Authentication Endpoints Retrieve Groups Get All Groups Get a Specific Group Create a Group Update a Group Delete a Group Possible Errors