@@ -4051,7 +4051,7 @@ components:
40514051 - recraft
40524052 - reka
40534053 - relace
4054- - sakana-ai
4054+ - sakana
40554055 - sambanova
40564056 - seed
40574057 - siliconflow
@@ -18544,7 +18544,7 @@ components:
1854418544 additionalProperties:
1854518545 nullable: true
1854618546 type: object
18547- sakana-ai :
18547+ sakana:
1854818548 additionalProperties:
1854918549 nullable: true
1855018550 type: object
@@ -21267,6 +21267,58 @@ components:
2126721267 $ref: '#/components/schemas/SubagentNestedTool'
2126821268 type: array
2126921269 type: object
21270+ SubmitGenerationFeedbackRequest:
21271+ description: Structured feedback about a specific generation
21272+ example:
21273+ category: incorrect_response
21274+ comment: The model repeated the same paragraph three times.
21275+ generation_id: gen-3bhGkxlo4XFrqiabUM7NDtwDzWwG
21276+ properties:
21277+ category:
21278+ description: The category of feedback being reported
21279+ enum:
21280+ - latency
21281+ - incoherence
21282+ - incorrect_response
21283+ - formatting
21284+ - billing
21285+ - api_error
21286+ - other
21287+ example: incorrect_response
21288+ type: string
21289+ comment:
21290+ description: An optional free-text comment describing the feedback
21291+ example: The model repeated the same paragraph three times.
21292+ maxLength: 1000
21293+ type: string
21294+ generation_id:
21295+ description: The generation to submit feedback on
21296+ example: gen-3bhGkxlo4XFrqiabUM7NDtwDzWwG
21297+ minLength: 1
21298+ type: string
21299+ required:
21300+ - generation_id
21301+ - category
21302+ type: object
21303+ SubmitGenerationFeedbackResponse:
21304+ description: Confirmation that the feedback was recorded
21305+ example:
21306+ data:
21307+ success: true
21308+ properties:
21309+ data:
21310+ properties:
21311+ success:
21312+ const: true
21313+ description: Whether the feedback was recorded
21314+ example: true
21315+ type: boolean
21316+ required:
21317+ - success
21318+ type: object
21319+ required:
21320+ - data
21321+ type: object
2127021322 SupportedParameters:
2127121323 additionalProperties:
2127221324 $ref: '#/components/schemas/CapabilityDescriptor'
@@ -24893,7 +24945,7 @@ paths:
2489324945 - recraft
2489424946 - reka
2489524947 - relace
24896- - sakana-ai
24948+ - sakana
2489724949 - sambanova
2489824950 - seed
2489924951 - siliconflow
@@ -27438,6 +27490,86 @@ paths:
2743827490 summary: Get stored prompt and completion content for a generation
2743927491 tags:
2744027492 - Generations
27493+ /generation/feedback:
27494+ post:
27495+ description: >-
27496+ Submit structured feedback on a generation the authenticated user made. [Management
27497+ key](/docs/guides/overview/auth/management-api-keys) required.
27498+ operationId: submitGenerationFeedback
27499+ requestBody:
27500+ content:
27501+ application/json:
27502+ example:
27503+ category: incorrect_response
27504+ comment: The model repeated the same paragraph three times.
27505+ generation_id: gen-3bhGkxlo4XFrqiabUM7NDtwDzWwG
27506+ schema:
27507+ $ref: '#/components/schemas/SubmitGenerationFeedbackRequest'
27508+ required: true
27509+ responses:
27510+ '200':
27511+ content:
27512+ application/json:
27513+ example:
27514+ data:
27515+ success: true
27516+ schema:
27517+ $ref: '#/components/schemas/SubmitGenerationFeedbackResponse'
27518+ description: Feedback recorded successfully
27519+ '400':
27520+ content:
27521+ application/json:
27522+ example:
27523+ error:
27524+ code: 400
27525+ message: Invalid request parameters
27526+ schema:
27527+ $ref: '#/components/schemas/BadRequestResponse'
27528+ description: Bad Request - Invalid request parameters or malformed input
27529+ '401':
27530+ content:
27531+ application/json:
27532+ example:
27533+ error:
27534+ code: 401
27535+ message: Missing Authentication header
27536+ schema:
27537+ $ref: '#/components/schemas/UnauthorizedResponse'
27538+ description: Unauthorized - Authentication required or invalid credentials
27539+ '404':
27540+ content:
27541+ application/json:
27542+ example:
27543+ error:
27544+ code: 404
27545+ message: Resource not found
27546+ schema:
27547+ $ref: '#/components/schemas/NotFoundResponse'
27548+ description: Not Found - Resource does not exist
27549+ '429':
27550+ content:
27551+ application/json:
27552+ example:
27553+ error:
27554+ code: 429
27555+ message: Rate limit exceeded
27556+ schema:
27557+ $ref: '#/components/schemas/TooManyRequestsResponse'
27558+ description: Too Many Requests - Rate limit exceeded
27559+ '500':
27560+ content:
27561+ application/json:
27562+ example:
27563+ error:
27564+ code: 500
27565+ message: Internal Server Error
27566+ schema:
27567+ $ref: '#/components/schemas/InternalServerResponse'
27568+ description: Internal Server Error - Unexpected server error
27569+ summary: Submit feedback for a generation
27570+ tags:
27571+ - Generations
27572+ x-speakeasy-name-override: submitFeedback
2744127573 /guardrails:
2744227574 get:
2744327575 description: >-
0 commit comments