Skip to main content

REST Commands

Execute manual REST API requests.

rest​

Execute a manual REST API request against the configured connection.

mage-remote-run rest [path] [options]

Options​

  • -m, --method <method>: HTTP Method (GET, POST, PUT, DELETE)
  • -d, --data <data>: Request body data (JSON)
  • -q, --query <string>: Query parameters (e.g. "a=1&b=2")
  • --page-size <number>: Search Criteria Page Size
  • --current-page <number>: Search Criteria Current Page
  • -c, --content-type <type>: Content-Type (default: application/json)
  • -f, --format <type>: Output format (json, xml)

Examples​

Interactive Mode

mage-remote-run rest

GET Request

mage-remote-run rest V1/store/websites

GET Request with Method

mage-remote-run rest V1/customers/1 -m GET

POST Request with Data

mage-remote-run rest V1/customers -m POST -d '{"customer": {"email": "test@example.com", ...}}'

Query Parameters

mage-remote-run rest V1/products -q "searchCriteria[pageSize]=10&fields=items[sku,name]"

Pagination Shortcuts

mage-remote-run rest V1/products --page-size 10 --current-page 1

Output Format

mage-remote-run rest V1/store/websites -f json > websites.json