Getting started

Quickstart

Look around in the read-only demo, then run your first workflow and call it from a script.

1. Explore the demo

Open the demo — it signs you straight into a read-only account. Browse the workflows on the canvas, open past runs node by node, and check the operations dashboard.

2. Get an account

Accounts are invite-only: there is no public sign-up. The workspace admin creates your account with one of three roles —

viewer — read-only across workflows, executions and agents;
editor — also creates, edits and runs workflows and agents, and writes to memory and knowledge bases;
admin — also manages users, credentials and the audit log.

Then sign in to DirectStudio with the email and password you were given.

3. Run your first workflow

Open Welcome to DirectOS from the workflows list and press Run (⌘ ↵). Node statuses stream in live; when the run finishes, every node’s input, output, duration and — for AI nodes — model, tokens and cost are in the execution detail.

4. Call it from a script

Everything Studio does goes through the same REST API. Sign in once, mint a personal API key, and use it as a Bearer token from then on:

bash

# sign in — returns a 30-day session token
curl -X POST https://api.directos.dev/api/auth/login \
  -H 'content-type: application/json' \
  -d '{"email":"you@company.com","password":"…"}'

# mint a personal API key (no expiry until revoked) — the token is shown once
curl -X POST https://api.directos.dev/api/auth/api-keys \
  -H "authorization: Bearer $SESSION_TOKEN" \
  -H 'content-type: application/json' \
  -d '{"name":"ci"}'

# list your workflows
curl https://api.directos.dev/api/workflows -H "authorization: Bearer $DIRECTOS_KEY"

Next: the API reference for every endpoint, or Webhooks to trigger a workflow from another system.