Quickstart

pip install engini

npm install @engini/sdk

npm install -g @engini/cli

from engini import Engini

client = Engini()  # reads ENGINI_API_KEY
print(client.auth.whoami())

import { Engini } from "@engini/sdk";

const client = new Engini(); // reads ENGINI_API_KEY
console.log(await client.auth.whoami());

engini login --api-key $ENGINI_API_KEY
engini whoami

curl https://api.engini.io/v1/auth/whoami \
  -H "x-api-key: $ENGINI_API_KEY"

apps = client.applications.list(available=True)
tools = client.tools.get(applications=["monday"], limit=5)

const apps = await client.applications.list({ available: true });
const tools = await client.tools.get({ applications: ["monday"], limit: 5 });

engini applications list --available
engini tools list --application monday --limit 5

curl "https://api.engini.io/v1/tools?applicationSlug=monday&top=5" \
  -H "x-api-key: $ENGINI_API_KEY"

# programmatic creation - direct credentials:
conn = client.connections.create("monday", "My Monday", auth_id, {"ApiKey": "..."})
# OAuth apps need the sign-in flow - see /sdk/connections

// programmatic creation - direct credentials:
const conn = await client.connections.create("monday", "My Monday", authId, { ApiKey: "..." });
// OAuth apps need the sign-in flow - see /sdk/connections

engini connect monday
# ... walks you through auth, verifies the connection,
# and prints its connection_id - you'll use it in step 6

curl -X POST "https://api.engini.io/v1/connections" \
  -H "x-api-key: $ENGINI_API_KEY" -H "Content-Type: application/json" \
  -d '{"applicationSlug":"monday","connectionName":"My Monday","authenticationId":0,"fields":{"ApiKey":"..."}}'
# OAuth apps need the sign-in flow - see /examples/oauth-onboarding

result = client.tools.execute(
    "monday_create_item",
    {"name": "My first item"},
    connection_id=connection_id,   # omit to use your default connection
)
if result.is_success:
    print(result.output)

const result = await client.tools.execute(
  "monday_create_item",
  { name: "My first item" },
  { connectionId },   // omit to use your default connection
);
if (result.isSuccess) console.log(result.output);

# --connection takes the connection_id printed by `engini connect` in step 5
engini tools call monday_create_item --args '{"name":"My first item"}' --connection 3

curl -X POST "https://api.engini.io/v1/tools/monday_create_item/execute" \
  -H "x-api-key: $ENGINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"fields": {"name": "My first item"}}'