Recipes

Command-first answers for common Restish tasks.

Recipes solve one narrow job. Start with the command, then read the notes when you need variants or failure guidance.

Recipes that use api.rest.sh are intended to be runnable. Recipes that use private hostnames such as service.internal.test show the command shape for your own infrastructure.

Requests And Input

Output And Filtering

Auth And TLS


Post JSON From a File

Send a JSON request body from stdin.

Upload a File With Multipart

Send multipart/form-data with normal fields and a file.

Create, Patch, and Delete an Item Safely

Use the resettable /items fixture with a unique ID.

Get One Field From Every Item

Print one field per collection item.

Save a Response Unchanged

Save response body bytes instead of formatted output.

Download a File With Headers Preserved

Save raw bytes while capturing verbose headers separately.

Force JSON Output to a File

Write one JSON document to a file.

Count Items Across All Pages

Collect a paginated response before counting items.

Use External-Tool Auth

Delegate request auth to a local helper executable.

Use a Custom CA

Trust a private certificate authority for one request.

Use mTLS With a TLS Signer

Use a TLS signer plugin when the client private key must stay outside Restish.