Make Endpoints from the shell

make-endpoints-cli calls Make Endpoints, the single-call wrappers around app actions (google-docs get-document, slack send-message, ...). Every call runs in a team and, for most endpoints, through one of that team's connections. The flow is always the same: find the team, see what it can run, inspect the endpoint, pick a connection, call.

Ground rules. Never guess a team id, connection id or field name; each one comes from a command below. --help works on any command. Run describe before the first call; most endpoints require more than the obvious field. Output is JSON by default, so pipe it to jq, but only once a call succeeds, because a pipe hides the error text. Exit code 2 is a Make API error, with the message on stderr; exit code 1 is a usage or validation error. Every call runs as the user of the API key, in exactly one team per call.

Auth

Credentials resolve in this order: --api-key and --zone flags, then MAKE_API_KEY and MAKE_ZONE, then the config saved by make-cli login. The key needs organizations:read for step 1, apps:read for step 2, connections:read for step 4 and endpoints:run for step 5. Error [401]: Required scope: ... names the missing scope, which only a new key can fix.