> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mixus.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# mixus API quick start

> Get started with mixus API in 5 minutes

# Quick start - mixus API

## Get started in 5 minutes

### Step 1: Generate API key (2 minutes)

1. Sign in to [app.mixus.ai](https://app.mixus.ai)
2. Navigate to [Integrations → API Keys](https://app.mixus.ai/integrations/api-keys)
3. Click **"Generate API Key"**
4. Configure your key:
   * **Name:** "My First API Key"
   * **Permissions:** ✓ eval:create, ✓ eval:read
   * **Expiration:** 30 days
5. Click **"Generate API Key"**
6. **Copy the key immediately** (shown only once!)

Your key will look like: `mxs_eval_A7k2mN9pQx4vZ8wB3cF1dG6hJ5lK0sM`

***

### Step 2: Make your first API call (1 minute)

```bash theme={null}
export MIXUS_API_KEY="mxs_eval_YOUR_KEY_HERE"

curl -X POST https://app.mixus.ai/api/eval/create-task-agent \
  -H "Authorization: Bearer $MIXUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskName": "Quick Test",
    "taskDescription": "Calculate 15% of $50,000 and explain the result",
    "checkpoints": [{
      "stage": "calculation",
      "description": "Perform calculation",
      "verificationQuestion": "Is the result $7,500?"
    }],
    "testMode": "with-verification",
    "assignedReviewer": "your-email@example.com"
  }'
```

**Response:**

```json theme={null}
{
  "success": true,
  "executionId": "670a1b2c3d4e5f6g7h8i9j0k",
  "chatUrl": "https://app.mixus.ai/chat/670a1b2c3d4e5f6g7h8i9j0l"
}
```

***

### Step 3: Track progress (2 minutes)

```bash theme={null}
# Save the execution ID from previous response
EXEC_ID="670a1b2c3d4e5f6g7h8i9j0k"

# Check status
curl "https://app.mixus.ai/api/eval/status/$EXEC_ID" \
  -H "Authorization: Bearer $MIXUS_API_KEY"
```

**Or** open the chat URL in your browser to watch in real-time!

***

## What just happened?

1. ✅ You created an evaluation task via API
2. ✅ mixus agent started working on it
3. ✅ Agent will pause at the checkpoint for your verification
4. ✅ You can approve/reject via email or web UI
5. ✅ Agent continues and completes the task
6. ✅ You get metrics on performance

***

## Next steps

### Try AI auto-detection

Let AI decide where to add verification points:

```bash theme={null}
curl -X POST https://app.mixus.ai/api/eval/create-task-agent \
  -H "Authorization: Bearer $MIXUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskName": "AI Auto-Detect Test",
    "taskDescription": "Research top 3 AI companies, analyze their pricing, and email summary to team@company.com",
    "autoDetectCheckpoints": true,
    "testMode": "with-verification",
    "assignedReviewer": "your-email@example.com"
  }'
```

The AI will automatically add verification before sending the email!

### Explore more

* [Complete API Reference](./eval-api.mdx) - All endpoints and parameters
* [Code Examples](../evaluation/examples.mdx) - Python, JavaScript, cURL examples
* [Best Practices](./overview.mdx#best-practices) - Security and optimization tips

***

## Common questions

**Q: How long does an eval take?**\
A: Typically 30 seconds to 5 minutes, depending on task complexity.

**Q: Can I run multiple evals at once?**\
A: Yes! Up to 10 concurrent executions per API key.

**Q: What if I lose my API key?**\
A: Generate a new one and revoke the old one immediately.

**Q: Can I skip human verification?**\
A: Yes, use `testMode: "without-verification"` for fully automated runs.

**Q: How do I get notified when complete?**\
A: Add a `webhookUrl` to receive completion notifications.

***

**That's it! You're now ready to use the mixus API** 🚀

Start building with [complete documentation](./eval-api.mdx) or explore [code examples](../evaluation/examples.mdx).