REST API walkthrough (cURL)

export ENGINI_API_KEY=eng_...
BASE=https://api.engini.io/v1
AUTH="x-api-key: $ENGINI_API_KEY"

curl -s "$BASE/auth/whoami" -H "$AUTH"

curl -s "$BASE/applications?available=true&top=20" -H "$AUTH" | jq '.items[].slug'

curl -s "$BASE/applications/outlook" -H "$AUTH" \
  | jq '.authenticationMethods[] | {authenticationId, authenticationName, requiresOAuthSignIn, isDefault}'

curl -s -X POST "$BASE/connections" -H "$AUTH" -H "Content-Type: application/json" -d '{
  "applicationSlug": "slack",
  "connectionName": "Sales workspace",
  "authenticationId": 2,
  "fields": { "token": "xoxb-..." }
}'

# a. get the sign-in URL + state
curl -s -X POST "$BASE/connections/get-sign-in-url" -H "$AUTH" -H "Content-Type: application/json" \
  -d '{"applicationSlug": "outlook", "authenticationId": 0}'
# -> { "signInUrl": "...", "state": "<guid>" }

# b. the user authorizes in a browser at signInUrl; poll until the token lands
curl -s "$BASE/connections/access-token/<state>" -H "$AUTH"
# -> null body while pending (keep polling); then { "status": "completed", "connectionData": {...} }

# c. create the connection - pass the sign-in's state as oauthState; the server derives
#    the credentials from its own record of the sign-in, so fields carries nothing here
curl -s -X POST "$BASE/connections" -H "$AUTH" -H "Content-Type: application/json" -d '{
  "applicationSlug": "outlook",
  "connectionName": "My Outlook",
  "authenticationId": 0,
  "oauthState": "<state>",
  "fields": {}
}'

curl -s -X PUT "$BASE/connections/42/default" -H "$AUTH"

curl -s "$BASE/tools?applicationSlug=outlook&top=10" -H "$AUTH" | jq '.items[].toolSlug'
curl -s "$BASE/tools/outlook_send_mail" -H "$AUTH" | jq '{inputSchema, supportsFilters, supportsTopOffset}'

curl -s -X POST "$BASE/tools/outlook_send_mail/execute?connectionId=42" \
  -H "$AUTH" -H "Content-Type: application/json" \
  -d '{ "fields": { "to": "alex@acme.com", "subject": "Hi", "body": "From the Engini API." } }'

{ "isSuccess": true, "output": { ... }, "historyId": 12345, "executionInfo": { ... } }