Skip to main content
Industry leading Web Agent: Altrina is the state-of-the-art browser agent, beating OpenAI’s CUA and Anthropic’s Computer Use across benchmarks. Details in our blog post →Now you have access too!

​
1. Get Your API Key

Sign up and get your API key at app.altrina.com/settings

​
2. Run Your First Agent

curl -X POST "https://api.altrina.com/v1/run_browser_agent" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "directive": "Go to news.ycombinator.com and get the titles and points of the top 3 stories on the homepage"
  }'

​
3. Get Results

The agent typically runs for a few minutes. You have two options:

​
Option 1: Watch on the Altrina Platform

Visit the history_url from step 2 to:
  • Watch live - See the browser in real-time
  • View step details - Review every action with screenshots
  • Take control - Jump in anytime to guide the agent

​
Option 2: Poll with the API

Check status and get results programmatically: 
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.altrina.com/v1/get_job_status/{job_id}"

​
Triggering Workflows via API

You can trigger any saved workflow by sending a POST request with your API key. No user_id is needed in the URL.

​
1. Trigger the Workflow

curl -X POST "https://api.altrina.com/workflows/run-with-payload/{workflow_id}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": "San Francisco"
  }'
Replace {workflow_id} with your workflow’s ID — you can find it in the Studio URL (e.g. app.altrina.com/gallery/studio/abc123-...) or in the Upon receiving a webhook trigger modal, where it’s pre-filled into the endpoint URL. The payload field is optional. If your workflow has no input parameters, send an empty body {}. When the workflow has input parameters, Altrina uses an LLM to map your free-form payload text into the declared parameters. For example, if the workflow expects a City parameter, sending "San Francisco" will set City to "San Francisco".

​
2. Poll for Results

Use the returned job_id to poll for the workflow result: 
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.altrina.com/v1/get_job_status/{job_id}"
You can also set up workflows to run on a schedule or via email trigger from the Studio UI. The API webhook is best when you need to trigger workflows from external systems like CI/CD, Zapier, or custom backends.

​
Configuration Options

​
VLM Models

Altrina Model Performance Comparison
ModelCredits/StepNotes
gemini/gemini-3-flash-preview1Fastest and cheapest option
o33Good accuracy, cost-effective
claude-sonnet-4-202505145[Default] Recommended for most tasks
gpt-4o5Strong general-purpose model
claude-opus-4-1-2025080525Highest accuracy for complex tasks

​
Bring Your Own Browser (BYOB)

{
  "directive": "Navigate to the dashboard and extract the monthly revenue",
  "cdp_url": "ws://localhost:9222/devtools/browser/abc123"  
  // Connect to your Chrome browser anywhere
}

​
Browser Settings

  • width/height: Viewport size (320-4096px)
  • residential_ip: Residential proxy setting. false to disable, true for US proxy, or an ISO country code (us, ca, gb, de, fr, au, jp, in, br, kr)
  • max_duration_minutes: Max runtime (1-240 min, default: 30)
  • idle_timeout_minutes: Stop if idle (1-60 min, default: 2)
  • keep_browser_open: Keep session alive after completion
  • use_user_browser_profile: Use persistent user profile (cookies, localStorage) instead of fresh profile per job (default: false)
These options are only used when Altrina spins up a new browser session (not BYOB).

​
Pausing & Resuming Jobs

You can pause a running job and resume it later: 
curl -X POST "https://api.altrina.com/v1/pause_job/{job_id}" \
  -H "Authorization: Bearer YOUR_API_KEY"
Pause Timeout: Paused jobs will automatically fail if not resumed within 6 hours.

​
What’s Next?

​
Tips

  1. Base URL: Browser agent endpoints use https://api.altrina.com/v1, workflow endpoints use https://api.altrina.com/workflows
  2. Auth Header: Include Authorization: Bearer YOUR_API_KEY in all requests
  3. Rate Limits: 10 req/min for browser agent, 60 req/min for status/balance
  4. Watch Live: Use the live_url to see your agent work in real-time
  5. Natural Language: Write directives like you’d instruct a human
  6. Be Specific: Clear instructions get better results
  7. Check Credits: Monitor usage with /v1/get_credit_balance
Launch YC: Altrina API