HTTP API
Images
1 operations. {prefix} is the route prefix passed to
MapTracon; the template uses /tracon.
POST {prefix}/api/images/generate
Section titled “POST {prefix}/api/images/generate”Operation ID: TraconGenerateImage
Generates images and saves them as attachments.
This is an operator action outside a run. Generated images are saved as attachments and the response returns their descriptors and configured cost. To record usage in tool_invocations, use the agent’s generate_image tool instead.
Authorization: bearer authentication; Operator role policy when that policy is registered; RunsWrite API-key scope.
Request body (required):
application/json→ImageGenerationOperatorRequest
| Response | Body | Headers |
|---|---|---|
| 200 OK | application/json → ImageGenerationOperatorResponse |
— |
| 400 Bad Request | application/problem+json → ProblemDetails |
— |
| 502 Bad Gateway | application/problem+json → ProblemDetails |
— |