Estimate AI usage and cost before analysis

post

https://talk.perspio.io/reports/v3/{id}/ai/estimate

Estimate Perspio AI token burn and quota headroom for the same request shape as analyse.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

JSON schema describing the report shape.

Query Params

model

string

Optional model override. Canonical channel for overriding the model; takes precedence over the deprecated AIAnalysisRequest.model body field when both are supplied.

Body Params

AI analysis request (same as analyse)

JSON schema describing the report shape.

tenantId

string

Identifier of the owning tenant.

userId

string

User Id.

correlationId

string

Client-supplied correlation id, echoed back for request tracing.

skillId

string

required

Skill id to execute.

reportDefinitionId

string

Report Definition Id.

reportRunId

string

required

Identifies saved report-run artifacts (CSV + metadata) loaded server-side.

agentId

string | null

Agent Id.

model

string | null

deprecated

Deprecated. Prefer the model query parameter on analyse/estimate/validate, which takes precedence over this body field when both are supplied. Scheduled for removal after 2026-04-15.

userQuery

string | null

User Query.

context

object | null

Responses

401

Invalid API Key provided or Invalid Bearer token

200Success

400Invalid Request

404Resource Not Found

500Internal Server Error