The Redox Platform API is an API tool you can use to manage your Redox configuration. With the Platform API, you can:
- Configure your setup: Create and manage your connectivity settings (i.e., sources, destination, authentication) in your Redox organization.
- Manage user access: Perform the administrative functions of assigning user roles to any users in your Redox organization.
- Set up data operations: Create and manage filters, config modifiers, and translation sets without having to switch contexts by logging into another UI.
- Monitor your traffic: Set up traffic alert rules to proactively monitor your traffic or search and export your logs.
In more technical terms, the Redox Platform API is a RESTful JSON utility that you can use to automate your Redox organization’s monitoring and workflows. Review a list of available Platform API endpoints.
All Platform API requests should be sent to https://api.redoxengine.com/platform/{endpoint}. For the {endpoint} segment, check out each endpoint for the specific endpoint URL.
You authenticate a Platform API request with a user-level API key. Find and manage them in the user menu on the bottom left of the Redox dashboard. Learn how to authenticate a user-level API key.

Depending on the Platform API endpoint, the request might include path, query, and/or request parameters:
- Path parameters: These are typically required parameters, like a log ID if querying for a specific log. These go directly into the endpoint URL. See path parameters in the table below.Example: Path parametersbash
- Query parameters: These are extra parameters for filtering, sorting, or controlling response output. These go in the query string (e.g., ?param=123).you can use in the URL to refine a query. Any datetime request parameters are in ISO 8601 format (e.g., 2023-01-10T19:46:40.081Z).Example: Query parameterbash
- Request parameters: These are typically optional parameters to refine the query further or populate the settings for a new asset you’re creating. The --data header usually contains the request body with these types of parameters.Example: Request parametersbash
These common path parameters typically have to be included in the endpoint URL, depending on the endpoint you’re using:
Path parameter | Type | Description |
---|---|---|
:version | string | This is the version of the Platform API endpoint, which you can find in the endpoint spec. |
organizationID | string | Some endpoints require you to specify which Redox organization you’re making the request for. You can locate your organization ID on the Organization Profile page of the Redox dashboard. |
environmentID | string | Some endpoints require you to specify which environment you’re making the request for (e.g., development, staging, production). For example, traffic alert rules only apply to specific environments, so you’d need to identify which environment in the endpoint path. |
Every response from the Platform API is contained in a wrapper object, even when the returned value is already an object. This payload wrapper contains a:
- meta object: Contains metadata about your request.
- payload object: Contains the results related to your request. These fields return a single result (singular field name) or an array of results (plural field name).
Pagination breaks up the results of a query into pages, or sets. Instead of returning all possible results at once, you can view a page at a time.
Refer to the supported query parameters in each endpoint to paginate results. You can query for pages of results using the URLs in the meta.page.links object in the paginated response.
The URL values return the relevant page of results. Sometimes, only a subset of links are available. For example, a next property isn’t populated on the last page of results. But you can always use the available URLs to fetch additional pages of results.
The meta.page object might contain other properties or objects. For example, you might see metadata counts, which display the total size of the result set, including totalRecords, totalPages, and pageSize. These may be useful for troubleshooting purposes, but shouldn’t be functionally relied upon.
Platform API requests time out after about 1 minute, at which point Redox returns a 504 Gateway Timeout. If a request continues timing out, we recommend defining a shorter time period for results by using these request parameters:
- updatedAfter and updatedBefore
- createdAfter and createdBefore
If there are any errors, they’re returned in a standard payload.
Here are a couple of common Platform API status errors:
Error code | Notes |
---|---|
200 | A Platform API request references a collection of objects (e.g., /resources) but there aren’t results for that resource, or asset. The 200 code is returned with an empty results array. |
404 | A Platform API request references a specific object (e.g., /<resource>/:id), but that resource, or asset, doesn’t exist. |