---
title: "Send guidance to a running job"
method: POST
path: "/v1/autoimprove/job/{jobId}/guidance"
tags: ["Autoimprove"]
---

# Send guidance to a running job

`POST /v1/autoimprove/job/{jobId}/guidance`

## Request

- Base URL: `https://api.roark.ai`
- URL: `https://api.roark.ai/v1/autoimprove/job/{jobId}/guidance`
- Auth: HTTP bearer

Steer Roark mid-job. The message is folded into its next decision and is binding. Accepted while the job is live (RUNNING, NEEDS_INPUT, or PAUSED); a concluded job returns a conflict.

## Path parameters

- `jobId` string, uuid, required

## Request body

- AutoimproveTextInput
  - `text` string, required: The message for Roark.

## Response `200`

The guidance was queued for the next decision.

- object
  - `data` object, required
    - `accepted` true, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Autoimprove job not found
- `409`: The job has concluded and no longer takes guidance
- `429`: Too Many Requests
- `500`: Internal Server Error

## Changes

> 188 revisions in range; 1 not diffed.

- **2026-09-21** `99617fc5ccab`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/roarkhq/apis/roark-analytics-api/changes/v1/autoimprove/job/:jobId/guidance/post.md)

---

[API](https://skmtc.dev/roarkhq/apis/roark-analytics-api.md) - [All operations](https://skmtc.dev/roarkhq/apis/roark-analytics-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roarkhq/apis/roark-analytics-api/revisions/efc3377249d1?raw)