Launch Your First Run

The main Salambo UI is optimized for configuration, monitoring, and operations. In most setups, actual runs are started through the v1 runtime API or by another system that calls it on your behalf.

Before You Launch

Make sure all of the following are true:

• the agent is active
• the agent has a snapshot assigned
• required secrets are present in Environment Variables
• the network policy allows the external services the agent must reach
• you have an API key with the responses:write scope

The Fastest Path

1. Open API Keys and create a key if you do not already have one.
2. List models from the v1 API to confirm your agent slug appears there.
3. Send a POST request to /api/v1/responses using that agent slug as the model.
4. Open the Salambo dashboard and the agent page to watch the run appear.
5. Open the run detail page to inspect events, responses, artifacts, and terminal access.

Minimal Example

curl -X POST "https://YOUR_DOMAIN/api/v1/responses" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "your-agent-slug",
    "input": "Run a basic smoke test and summarize the result.",
    "store": true
  }'

The important details are:

• model must be the agent slug
• store must be true
• your key must include responses:write

Where To Watch The Run

Use these parts of the app:

• Dashboard for a quick view of recent activity and attention items
• Agents to filter recent runs by agent
• Run detail page for event logs, artifacts, responses, and live terminal access when the sandbox is running

If Nothing Appears

Check these first:

• the API key has the right scope
• the agent is still active
• the request used the correct agent slug
• the workspace billing status is not blocking runs
• the agent has a snapshot and valid network/secrets configuration

Next Reading

• API keys and authentication
• Use the v1 runtime API
• Inspect run details