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}'

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/GetSignInUrl" -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/AccessToken/<state>" -H "$AUTH"
# -> null body while pending (keep polling); then { "status": "completed", "connectionData": {...} }

# c. create the connection from connectionData's key/values
curl -s -X POST "$BASE/connections" -H "$AUTH" -H "Content-Type: application/json" -d '{
  "applicationSlug": "outlook",
  "connectionName": "My Outlook",
  "authenticationId": 0,
  "fields": { "...": "values from connectionData" }
}'

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": { ... } }