Internal implementation reference
POST /v1/operations
Admit operation. Permissions, parameters, responses and examples.
Private service protocols are unsupported for external integration. Their schemas describe source declarations; they are not public service endpoints.
Read pinned handler: services/advisor_connector/app.py:1239
Admit operation
Admit operation through POST /v1/operations. 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.
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
| Status | Meaning and declared shape |
|---|---|
200 | Successful Response application/json · 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. |
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.
23 source error observations
| Status | Source detail | Recovery |
|---|---|---|
| 422 ↗ | Advisor provider fields do not match the connector contract | Correct the field or semantic validation error. Input values are omitted from control validation errors. |
| 422 ↗ | Advisor provider profile is invalid | Correct the field or semantic validation error. Input values are omitted from control validation errors. |
| 413 ↗ | connector request exceeds the bounded size | Reduce the authorized capture to the documented size and file limits. |
| 413 ↗ | connector request exceeds the bounded size | Reduce the authorized capture to the documented size and file limits. |
| 413 ↗ | invalid request length | Reduce the authorized capture to the documented size and file limits. |
| 422 ↗ | request fields do not match the connector contract | Correct the field or semantic validation error. Input values are omitted from control validation errors. |
| 422 ↗ | request must be one strict UTF-8 JSON object | Correct the field or semantic validation error. Input values are omitted from control validation errors. |
| 409 ↗ | Remote Advisor operation is already admitted | Refresh current revision and identity. A conflicting command must not be blindly repeated. |
| 409 ↗ | Advisor execution requires a signed single-use grant | Refresh current revision and identity. A conflicting command must not be blindly repeated. |
| 422 ↗ | Advisor generation prompt is invalid | Correct the field or semantic validation error. Input values are omitted from control validation errors. |
| 409 ↗ | Advisor execution grant is invalid | Refresh current revision and identity. A conflicting command must not be blindly repeated. |
| 409 ↗ | Remote Advisor execution grant was already used | Refresh current revision and identity. A conflicting command must not be blindly repeated. |
| 409 ↗ | Remote Advisor generation requires one exact disclosure confirmation | Refresh current revision and identity. A conflicting command must not be blindly repeated. |
| 409 ↗ | Remote Advisor disclosure confirmation does not match the exact provider and prompt | Refresh current revision and identity. A conflicting command must not be blindly repeated. |
| 422 ↗ | local Advisor generation does not accept remote confirmation | Correct the field or semantic validation error. Input values are omitted from control validation errors. |
| 409 ↗ | Remote Advisor disclosure confirmation is invalid | Refresh current revision and identity. A conflicting command must not be blindly repeated. |
| 422 ↗ | Advisor generation request does not match the bounded contract | Correct the field or semantic validation error. Input values are omitted from control validation errors. |
| 422 ↗ | Advisor generation must use the exact model with stream=false | Correct the field or semantic validation error. Input values are omitted from control validation errors. |
| 422 ↗ | Advisor prompt is empty or exceeds the bounded size | Correct the field or semantic validation error. Input values are omitted from control validation errors. |
| 422 ↗ | Advisor output schema does not match the exact bounded contract | Correct the field or semantic validation error. Input values are omitted from control validation errors. |
| 422 ↗ | Advisor options do not match the bounded contract | Correct the field or semantic validation error. Input values are omitted from control validation errors. |
| 422 ↗ | Advisor think option must be boolean | Correct the field or semantic validation error. Input values are omitted from control validation errors. |
| 422 ↗ | Advisor generation options exceed the exact bounded contract | Correct the field or semantic validation error. Input values are omitted from control validation errors. |
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
{}All referenced models remain in its components section. Browse control model definitions.