Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Modify a request’s method, URL, headers, or body before it is sent.
<request-name>.before.js in the same folder as your request file:
requests/
auth/
login.chttp
login.before.js ← runs before login.chttp
before.js in that folder:
requests/
auth/
before.js ← runs before every request in auth/ and subfolders
login.chttp
refresh.chttp
before.js runs first, then the request-level <name>.before.js. This means the request-level script always sees changes made by the folder-level script.| Variable | Type | Description |
|---|---|---|
request | object | The request about to be sent. Mutating this object changes what Postchi sends. |
env | object | All active environment variables as string key-value pairs. Read-only. |
fetch | function | The global fetch function. |
request object| Property | Type | Description |
|---|---|---|
request.method | string | HTTP method, e.g. "GET" |
request.url | string | Full URL including any template variables already resolved |
request.headers | object | Headers as { name: value } pairs |
request.body | string | null | Request body as a string, or null |
// Add a timestamp to every request
request.headers['X-Request-Time'] = new Date().toISOString();
// Append a version query parameter from the environment
const version = env.api_version || 'v1';
request.url = request.url + '?version=' + version;
// Add a nonce to the request body before sending
const body = JSON.parse(request.body);
body.nonce = Math.random().toString(36).slice(2);
request.body = JSON.stringify(body);
request.headers['Authorization'] = 'Bearer ' + env.api_token;
before.js so you only write it once and it applies to every request in that folder automatically.