API reference

Build Alf into your product

A typed REST API with first-class Python and .NET SDKs. Define your goals and guardrails in code; Alf handles the rest.

curl

curl https://api.askalf.help/v1/runs \
  -H "Authorization: Bearer sk-..." \
  -d goal="Fix flaky tests and open a PR" \
  -d approve[]="git.push"

Core endpoints

POST/v1/runs

Hand Alf a goal and start an autonomous run.

GET/v1/runs/{id}

Fetch the status, steps, and result of a run.

POST/v1/runs/{id}/approve

Approve a paused human-in-the-loop step.

GET/v1/connectors

List the apps and APIs Alf can operate.

POST/v1/skills/install

Install a Skills Store recipe for an agent.