Actions - Postchi

Quick Actions are standalone scripts that aren’t tied to any specific request. You run them manually from the actions panel whenever you need them. They’re ideal for workflows that span multiple requests — like logging in and saving a token, seeding test data, or resetting state between test runs.

File location

Store Quick Actions as .action.js files inside your project’s actions/ folder:

my-project/
  actions/
    login.action.js
    seed-data.action.js
  requests/
    ...

Available context

Postchi injects these variables into every Quick Action:

Variable	Type	Description
`env`	object	All active environment variables and secrets as string key-value pairs. Read-only.
`fetch`	function	The global `fetch` function.
`setEnvironmentVariable(key, value)`	function	Saves a variable to the active environment in `environments.cenv`.
`setSecret(key, value)`	function	Saves a secret to the active environment in `secrets.cenv`.
`executeRequest(relativePath)`	function	Executes a request file from your `requests/` folder by relative path. Returns a `ScriptResponse`.

`executeRequest` return value

executeRequest returns a ScriptResponse object:

Property	Type	Description
`status`	number	HTTP status code
`headers`	object	Response headers as `{ name: value }` pairs
`body`	string \| null	Response body as a string, or `null`

The path you pass to executeRequest is relative to your requests/ folder — for example, 'auth/login.chttp' resolves to requests/auth/login.chttp.

Examples

Log in and save the auth token

// Execute the login request and capture the auth token
const response = await executeRequest('auth/login.chttp');
if (response.status === 200) {
  const data = JSON.parse(response.body);
  setSecret('api_token', data.token);
  console.log('Logged in successfully');
} else {
  throw new Error('Login failed: ' + response.status);
}

Fetch an external value and save it

// Pull a config value from an external source
const res = await fetch('https://config.example.com/api-version');
const data = await res.json();
setEnvironmentVariable('api_version', data.version);

Chain multiple requests

// Log in, then seed some test data
const loginResponse = await executeRequest('auth/login.chttp');
const loginData = JSON.parse(loginResponse.body);
setSecret('api_token', loginData.token);

const seedResponse = await executeRequest('admin/seed-users.chttp');
if (seedResponse.status !== 201) {
  throw new Error('Seeding failed: ' + seedResponse.status);
}
console.log('Test data seeded successfully');

Running a Quick Action

Open the actions panel

Click the Actions section in the sidebar to see all .action.js files in your project.

Select an action

Click the action you want to run.

Run it

Click the run button. Postchi executes the script and applies any setEnvironmentVariable or setSecret calls immediately.

Error handling

If a Quick Action throws an error, Postchi shows the error message and does not apply any mutations from that run. Use throw new Error(...) to surface meaningful error messages when something goes wrong.

​File location

​Available context

​executeRequest return value

​Examples

​Log in and save the auth token

​Fetch an external value and save it

​Chain multiple requests

​Running a Quick Action

​Error handling

File location

Available context

`executeRequest` return value

Examples

Log in and save the auth token

Fetch an external value and save it

Chain multiple requests

Running a Quick Action

Error handling