API Keys

API keys let you authenticate programmatic requests to the Iara Data API.

Creating an API Key

1. Go to Settings → Manage API Keys
2. Click Create Key
3. Give it a name (e.g., "Production Pipeline")
4. Optionally set scopes to restrict access (e.g., ingest:write, kpi:read)
5. Click Create

warning

Copy your key immediately! The full key is only shown once. After closing the dialog, you'll only see a truncated version.

Managing Keys

Column	Description
Key	Truncated key with copy button
Name	Human-readable label
Scopes	Comma-separated list of permissions
Last Used	Relative timestamp (e.g., "2 hours ago")
Created	When the key was created

Actions

Action	Description
Copy	Copy the truncated key to clipboard
Rotate	Generate a new key value (old key stops working immediately)
Delete	Permanently remove the key

Available Scopes

Scope	Access
ingest:write	Upload data, create/manage pipelines
ingest:read	Read datasets and ingestion history
curupira:query	Use the AI chat
kpi:read	Read KPI values and dashboards
kpi:write	Create/modify KPIs and dashboards
analyze:invoke	Run analyses and investigations
billing:read	View billing and usage information
users:manage	Invite/manage team members
audit:read	View audit logs
keys:read	List API keys
keys:write	Create/rotate/delete API keys
webhooks:read	List webhooks
webhooks:write	Create/modify/delete webhooks

Usage Example

# Fetch your datasets
curl https://lake.iaradata.com/api/v1/datasets \
  -H "Authorization: Bearer sk_live_abc123..."

# Ask the AI a question
curl -X POST https://lake.iaradata.com/api/v1/curupira/ask \
  -H "Authorization: Bearer sk_live_abc123..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "question": "What was total revenue last month?",
    "mode": "agentic",
    "execute": true
  }'