---
title: "POST /alpha/repos/{provider}/{org}/{repo}/sessions/{sessionId}/solve"
method: POST
path: "/alpha/repos/{provider}/{org}/{repo}/sessions/{sessionId}/solve"
tags: ["solve"]
---

# POST /alpha/repos/{provider}/{org}/{repo}/sessions/{sessionId}/solve

`POST /alpha/repos/{provider}/{org}/{repo}/sessions/{sessionId}/solve`

## Request

- Base URL: `https://api.solverai.com`
- URL: `https://api.solverai.com/alpha/repos/{provider}/{org}/{repo}/sessions/{sessionId}/solve`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/laredo-labs/apis/solver-api/docs/alpha/repos/:provider/:org/:repo/sessions/:sessionId/solve/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `provider` 'github', required
- `org` string, required
- `repo` string, required
- `sessionId` string, required

## Request body

- SolveBody
  - `instruction` string, required
  - `numSteps` 8 | 16 | 24 | 32 | 40, required: The maximum number of steps to take when Solving

## Response `201`

Solve request submitted

- Turn
  - `sessionId` string, required
  - `id` string, required
  - `idx` integer, required
  - `startCommit` string, required
  - `endCommit` string
  - `status` 'pending' | 'running' | 'completed' | 'cancelled' | 'error', required
  - `error` string
  - `instruction` string, required

## Other responses

- `429`: Too Many Requests

## Changes

- **2025-04-25** `5fbb294f42ce`: 1 breaking, 1 warning, 5 info
  - request property `numSteps` was restricted to a list of enum values
  - removed the request property `invocationOptions`
  - added the new `16.00` enum value to the request property `numSteps`
  - added the new `24.00` enum value to the request property `numSteps`
  - …3 more
- **2025-04-25** `fdedda08e2a8`: 1 breaking
  - removed the enum value `gitlab` from the `path` request parameter `provider`
- **2025-04-25** `408c34dbecbd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/laredo-labs/apis/solver-api/changes/alpha/repos/:provider/:org/:repo/sessions/:sessionId/solve/post.md)

---

[API](https://skmtc.dev/laredo-labs/apis/solver-api.md) - [All operations](https://skmtc.dev/laredo-labs/apis/solver-api/llms.txt) - [OpenAPI document](https://skmtc.dev/laredo-labs/apis/solver-api/revisions/b15614bd714c?raw)