Skip to main content
POST
Solve a question

Authorizations

Authorization
string
header
required

A workspace API key.

Headers

idempotency-key
string

Stable retry key for this logical paid call. Reuse it after a timeout to receive the original result without duplicate work or spend.

Required string length: 1 - 255
x-sigmora-quote-only
string

Send 1 to get the price, balance and budget verdict without running anything.

Allowed value: "1"
x-sigmora-max-credits
string

The approved price; a call that would cost more is refused and nothing is charged.

Pattern: ^\d+$

Body

application/json
domain
enum<string>
required

Subject-specific solver to use. Every accepted value is listed below.

Available options:
math,
chemistry,
physics,
programming,
engineering,
statistics,
biology,
medicine,
business,
law,
economics,
psychology,
history,
generic
question
string
required

The question to solve, with worked steps.

Required string length: 1 - 20000
projectId
string
required

The existing project to file this work under. Create it with POST /v1/projects, then reuse its id across related calls. A project this workspace does not own answers not_found; the work is never silently filed somewhere else.

Required string length: 1 - 200
context
string

Definitions, constraints, prior work, or source material the solver should use.

Maximum string length: 20000
difficulty
enum<string>

Expected level. Defaults to intermediate; accepted values are listed below.

Available options:
beginner,
intermediate,
advanced,
expert
showSteps
boolean

Include the worked steps. Defaults to true.

includeExplanation
boolean

Explain why the method works, not only the calculation. Defaults to true.

Response

Success.

success
boolean
required
credits
number
required

What this call actually cost, which is not always what was quoted.

Example:

300

solution
object
required

The answer and the steps that reach it. The text is under result.

projectId
string

The existing project this work was filed under. It matches the projectId supplied by the caller after workspace ownership was verified.

Example:

"prj_9x2a4c"

creditBalance
number

Your balance after the charge. Absent when billing is disabled for the workspace.

Example:

3900

{key}
any