Skip to main content
POST
/
runs
/
{id}
/
steer
Steer Run
curl --request POST \
  --url https://api.example.com/runs/{id}/steer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "guidance": "Use a sliding window algorithm instead of fixed window.",
  "location": {
    "file": "src/middleware/rate-limit.ts",
    "line": 42
  }
}
'
{
  "errors": [
    {
      "status": "404",
      "title": "Not Found",
      "detail": "Run not found."
    }
  ]
}

Authorizations

Authorization
string
header
required

JWT bearer token issued by fabro-web. See the Authentication guide for details.

Path Parameters

id
string
required

Unique run identifier (ULID).

Body

application/json

Request body for sending inline steering guidance to a running agent.

guidance
string
required

Guidance text for the agent.

Example:

"Use a sliding window algorithm instead of fixed window."

location
object

A file and line location in the codebase.

Response

Steering accepted for processing