The API reference is in English.

Immutable source snapshot

POST /v1/generate

Generate. Permissions, parameters, responses and examples.

0.1.0 · source bccff29 · Current reference · Download OpenAPI specification

Private service protocols are unsupported for external integration. Their schemas describe source declarations; they are not public service endpoints.

Generate

Generate through POST /v1/generate. The parameters and declared response shapes below come from this exact source snapshot.

Internal protocol; unsupported for external integration. This page makes no request to a local installation.

Authority

Private service protocol. No public or third-party integration authority.

Inspect the authority source · Authentication guide

Parameters and headers

No explicit path, query or header parameters are declared here. The authority boundary still applies.

Request body

No typed JSON body is declared by this handler. That does not rule out source-level request parsing; inspect the pinned implementation, especially for internal connector protocols.

Responses

StatusMeaning and declared shape
200

Successful Response

application/json · object
{
  "additionalProperties": true,
  "title": "Response Generate V1 Generate Post",
  "type": "object"
}
409

Refresh current revision and identity. A conflicting command must not be blindly repeated. See source-linked error catalog.

413

Reduce the authorized capture to the documented size and file limits. See source-linked error catalog.

422

Correct the field or semantic validation error. Input values are omitted from control validation errors. See source-linked error catalog.

499

Reconcile current state and review the linked handler before retrying. See source-linked error catalog.

An empty or broad schema preserves the source contract. It is not a promise of an empty response.

Source-linked errors

Literal HTTP errors in this handler and same-file helper call graph, plus control middleware. Dynamic and cross-module failures may add other errors; source links are authoritative.

24 source error observations
StatusSource detailRecovery
422 ↗Advisor provider fields do not match the connector contractCorrect the field or semantic validation error. Input values are omitted from control validation errors.
422 ↗Advisor provider profile is invalidCorrect the field or semantic validation error. Input values are omitted from control validation errors.
499 ↗Dynamic detail; inspect sourceReconcile current state and review the linked handler before retrying.
413 ↗connector request exceeds the bounded sizeReduce the authorized capture to the documented size and file limits.
413 ↗connector request exceeds the bounded sizeReduce the authorized capture to the documented size and file limits.
413 ↗invalid request lengthReduce the authorized capture to the documented size and file limits.
422 ↗request fields do not match the connector contractCorrect the field or semantic validation error. Input values are omitted from control validation errors.
422 ↗request must be one strict UTF-8 JSON objectCorrect the field or semantic validation error. Input values are omitted from control validation errors.
409 ↗Remote Advisor operation was not exactly admittedRefresh current revision and identity. A conflicting command must not be blindly repeated.
409 ↗Advisor execution requires a signed single-use grantRefresh current revision and identity. A conflicting command must not be blindly repeated.
422 ↗Advisor generation prompt is invalidCorrect the field or semantic validation error. Input values are omitted from control validation errors.
409 ↗Advisor execution grant is invalidRefresh current revision and identity. A conflicting command must not be blindly repeated.
409 ↗Remote Advisor execution grant was already usedRefresh current revision and identity. A conflicting command must not be blindly repeated.
409 ↗Remote Advisor generation requires one exact disclosure confirmationRefresh current revision and identity. A conflicting command must not be blindly repeated.
409 ↗Remote Advisor disclosure confirmation does not match the exact provider and promptRefresh current revision and identity. A conflicting command must not be blindly repeated.
422 ↗local Advisor generation does not accept remote confirmationCorrect the field or semantic validation error. Input values are omitted from control validation errors.
409 ↗Remote Advisor disclosure confirmation is invalidRefresh current revision and identity. A conflicting command must not be blindly repeated.
422 ↗Advisor generation request does not match the bounded contractCorrect the field or semantic validation error. Input values are omitted from control validation errors.
422 ↗Advisor generation must use the exact model with stream=falseCorrect the field or semantic validation error. Input values are omitted from control validation errors.
422 ↗Advisor prompt is empty or exceeds the bounded sizeCorrect the field or semantic validation error. Input values are omitted from control validation errors.
422 ↗Advisor output schema does not match the exact bounded contractCorrect the field or semantic validation error. Input values are omitted from control validation errors.
422 ↗Advisor options do not match the bounded contractCorrect the field or semantic validation error. Input values are omitted from control validation errors.
422 ↗Advisor think option must be booleanCorrect the field or semantic validation error. Input values are omitted from control validation errors.
422 ↗Advisor generation options exceed the exact bounded contractCorrect the field or semantic validation error. Input values are omitted from control validation errors.

Read the recovery guide

Synthetic examples

These examples validate declared JSON shapes and formats. They contain no real installation data and do not prove runtime admission, cross-field validation, authority or successful work.

Response 200 JSON
{}
Download this service's complete OpenAPI

All referenced models remain in its components section. Browse control model definitions.