Unified API Testing: The Request Tester is the recommended way to test Unified API endpoints against specific accounts. It provides direct access to the API without requiring code or external tools.
Accessing the Request Tester
1
Navigate to Accounts
Go to Accounts in the StackOne dashboard.
2
Find your account
Locate the linked account you want to test.
3
Open Request Tester
Click the ellipsis menu (⋯) on the account row and select Request Tester.
Using the Request Tester
Select an Endpoint
Choose from available endpoints organized by category:| Category | Example Endpoints |
|---|---|
| HRIS | List Employees, Get Employee, List Time Off |
| ATS | List Candidates, Get Application, List Jobs |
| IAM | List Users, Get Group, List Roles |
| Documents | List Files, Get Folder, List Drives |
Configure Parameters
Depending on the endpoint, you can configure:- Path parameters – Required IDs like
employee_idorfile_id - Query parameters – Pagination, filtering, and expansion options
- Request body – For POST/PUT/PATCH requests
Common query parameters
Common query parameters
| Parameter | Description |
|---|---|
page_size | Number of results per page (default varies by endpoint) |
next | Pagination cursor for fetching next page |
updated_after | Filter by modification date |
expand | Include related resources in response |
Using the expand parameter
Using the expand parameter
Some endpoints support expanding related data. For example, when listing employees you might expand
work_location or manager to include those details inline.See Using Expand and Include Parameters for details.Execute and Inspect
Click Send Request to execute. The response panel shows:- Status code – HTTP status (200, 400, 404, etc.)
- Response body – JSON data returned by the API
- Response headers – Including rate limit information
- Timing – Request duration
Troubleshooting with Request Tester
The Request Tester is particularly useful for debugging:Connection issues
Connection issues
If an account shows an error status, use the Request Tester to execute a simple request (like listing records). The response will reveal:
- Authentication failures (401/403)
- Token expiration
- Permission issues
- Provider API errors
Missing data
Missing data
When expected data isn’t appearing:
- Test the specific endpoint directly
- Check if the data exists in the source system
- Review field mappings in the response
- Verify scopes/permissions in the integration configuration
Pagination problems
Pagination problems
To debug pagination:
- Make an initial request with a small
page_size - Copy the
nextcursor from the response - Make a follow-up request with that cursor
- Verify data continuity between pages
Slow responses
Slow responses
If requests are slow:
- Check the response timing in the panel
- Try smaller
page_sizevalues - Review Request Logs for detailed timing breakdown
Request Tester vs AI Playground
| Feature | Request Tester | AI Playground |
|---|---|---|
| Purpose | Direct API testing | Natural language exploration |
| Best for | Debugging, verification | Discovery, prototyping |
| Input | Structured parameters | Natural language prompts |
| Output | Raw API response | AI-interpreted results |
| Unified APIs | Recommended | Supported |
| Provider actions | Supported | Supported |