FAfabro-sh
Runs

Create Run Pull Request

Changed on

Durably requests creation of a pull request for a completed run. The server generates the pull request content and creates the GitHub pull request after this request returns. Poll the URL in the Location response header until the creation succeeds or fails.

If a creation is already pending for the run, the response returns that creation unchanged; any different model or force values in the new request are ignored.

post/api/v1/runs/{id}/pull_request

Request

  • The document declares no server URL.
  • Auth
    • HTTP bearer
    • or API key in cookie __fabro_session

Path parameters

idstring required

Unique run identifier (ULID).

Request body

forceboolean required

Create the pull request even if the run did not finish with succeeded or partially_succeeded.

modelstring nullable

Optional model override for generating the pull request description.

Example request

{
  "model": "claude-sonnet-4-6"
}

Response

Pull request creation was durably accepted

idstring required

Stable identifier for one explicit pull request creation request.

status'pending' | 'succeeded' | 'failed' required

Durable state of a pull request creation request.

modelstring required

Resolved model identifier used to generate the pull request content.

forceboolean required

Whether creation was allowed for a run without a successful conclusion.

requested_atstring date-time required
updated_atstring date-time required
errorstring nullable

Example response

{
  "id": "01KYYK70WTZT2E551P3H5P0059",
  "pull_request": {
    "owner": "fabro-sh",
    "repo": "fabro",
    "number": 123,
    "html_url": "https://github.com/fabro-sh/fabro/pull/123"
  }
}

Changes

  • efc644ab09d4Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

  • 359433692f06Revision changes
    • breaking

      removed the success response with the status

    • info

      removed the non-success response with the status

    • info

      added the success response with the status