> ## Documentation Index > Fetch the complete documentation index at: https://gproxy.leenhawk.com/llms.txt > Use this file to discover all available pages before exploring further. # GET /v1/interactions/{id} > Available at the instance root or under a provider/namespace prefix. Shared paths select the wire dialect from client headers; without dialect evidence, the first listed route wins. ## OpenAPI ````yaml /generated/openapi.json get /v1/interactions/{id} openapi: 3.1.0 info: description: >- Forwarding, management, portal and OAuth APIs generated from Rust types. Input and output schemas preserve their respective Serde contracts. Streaming events and WebSocket messages are documented alongside HTTP payloads. title: GPROXY HTTP API version: 4.2.1 servers: [] security: - bearer: [] - anthropicKey: [] - googleKey: [] - queryKey: [] paths: /v1/interactions/{id}: get: tags: - Forwarding summary: GET /v1/interactions/{id} description: >- Available at the instance root or under a provider/namespace prefix. Shared paths select the wire dialect from client headers; without dialect evidence, the first listed route wins. parameters: - in: path name: id required: true schema: type: string - description: '' in: query name: api_version required: false schema: type: - string - 'null' - description: '' in: query name: last_event_id required: false schema: type: - string - 'null' - description: '' in: query name: stream required: false schema: type: - boolean - 'null' responses: 2XX: content: application/json: schema: $ref: '#/components/schemas/Output_Interaction' text/event-stream: schema: type: string x-event-schema: $ref: '#/components/schemas/Output_InteractionStreamEvent' description: Successful protocol response default: content: application/json: schema: anyOf: - $ref: '#/components/schemas/Output_Envelope' - properties: error: $ref: '#/components/schemas/Output_ErrorDetail' required: - error type: object - allOf: - $ref: '#/components/schemas/Output_ErrorEvent' - properties: type: const: error required: - type type: object - properties: error: $ref: '#/components/schemas/Output_GenerateContentError' required: - error type: object text/plain: schema: type: string description: Gateway or upstream error components: schemas: Output_Interaction: additionalProperties: true properties: agent: type: - string - 'null' continuation_token: type: - string - 'null' created: type: - string - 'null' environment_id: type: - string - 'null' errors: items: $ref: '#/components/schemas/Output_InteractionError' type: array id: type: string model: type: - string - 'null' object: type: - string - 'null' previous_interaction_id: type: - string - 'null' service_tier: type: - string - 'null' status: type: string steps: items: $ref: '#/components/schemas/Output_InteractionStep' type: array updated: type: - string - 'null' usage: anyOf: - $ref: '#/components/schemas/Output_InteractionUsage' - type: 'null' required: - id - status type: object Output_Envelope: properties: error: $ref: '#/components/schemas/Output_EnvelopeBody' required: - error type: object Output_ErrorDetail: properties: code: type: - string - 'null' message: type: string param: type: - string - 'null' type: type: - string - 'null' required: - message type: object Output_ErrorEvent: additionalProperties: true properties: error: $ref: '#/components/schemas/Output_StreamError' request_id: type: - string - 'null' required: - error type: object Output_GenerateContentError: additionalProperties: true properties: code: format: int64 type: integer details: items: true type: - array - 'null' message: type: string status: type: - string - 'null' required: - code - message type: object Output_InteractionError: additionalProperties: true properties: code: type: - string - 'null' message: type: - string - 'null' type: object Output_InteractionStep: oneOf: - $ref: '#/components/schemas/Output_InteractionStepBody' properties: type: const: user_input type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionStepBody' properties: type: const: model_output type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionStepBody' properties: type: const: thought type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionStepBody' properties: type: const: function_call type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionStepBody' properties: type: const: function_result type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionStepBody' properties: type: const: code_execution_call type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionStepBody' properties: type: const: code_execution_result type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionStepBody' properties: type: const: google_search_call type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionStepBody' properties: type: const: google_search_result type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionStepBody' properties: type: const: google_maps_call type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionStepBody' properties: type: const: google_maps_result type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionStepBody' properties: type: const: url_context_call type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionStepBody' properties: type: const: url_context_result type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionStepBody' properties: type: const: file_search_call type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionStepBody' properties: type: const: file_search_result type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionStepBody' properties: type: const: mcp_server_tool_call type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionStepBody' properties: type: const: mcp_server_tool_result type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionStepBody' properties: type: const: processing_call type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionStepBody' properties: type: const: processing_result type: string required: - type type: object Output_InteractionUsage: additionalProperties: true properties: cached_tokens_by_modality: items: $ref: '#/components/schemas/Output_InteractionModalityTokens' type: array grounding_tool_count: items: $ref: '#/components/schemas/Output_InteractionGroundingToolCount' type: array initial_input_tokens: format: uint64 minimum: 0 type: - integer - 'null' input_tokens_by_modality: items: $ref: '#/components/schemas/Output_InteractionModalityTokens' type: array output_tokens_by_modality: items: $ref: '#/components/schemas/Output_InteractionModalityTokens' type: array tool_use_tokens_by_modality: items: $ref: '#/components/schemas/Output_InteractionModalityTokens' type: array total_cached_tokens: format: uint64 minimum: 0 type: - integer - 'null' total_input_tokens: format: uint64 minimum: 0 type: - integer - 'null' total_output_tokens: format: uint64 minimum: 0 type: - integer - 'null' total_thought_tokens: format: uint64 minimum: 0 type: - integer - 'null' total_tokens: format: uint64 minimum: 0 type: - integer - 'null' total_tool_use_tokens: format: uint64 minimum: 0 type: - integer - 'null' type: object Output_EnvelopeBody: properties: code: type: string message: type: string required: - code - message type: object Output_StreamError: additionalProperties: true properties: message: type: string type: $ref: '#/components/schemas/Output_StreamErrorType' required: - type - message type: object Output_InteractionStepBody: additionalProperties: true description: >- Fields shared by native step variants; vendor-specific fields remain in rest. properties: arguments: true call_id: type: - string - 'null' content: items: $ref: '#/components/schemas/Output_InteractionContent' type: array id: type: - string - 'null' is_error: type: - boolean - 'null' name: type: - string - 'null' result: true server_name: type: - string - 'null' signature: type: - string - 'null' status: type: - string - 'null' summary: items: $ref: '#/components/schemas/Output_InteractionContent' type: array type: object Output_InteractionModalityTokens: additionalProperties: true properties: modality: type: string tokens: format: uint64 minimum: 0 type: integer required: - modality - tokens type: object Output_InteractionGroundingToolCount: additionalProperties: true properties: count: format: uint64 minimum: 0 type: integer type: type: string required: - type - count type: object Output_StreamErrorType: enum: - api_error - authentication_error - billing_error - invalid_request_error - not_found_error - overloaded_error - permission_error - rate_limit_error - timeout_error - conflict_error - request_too_large type: string Output_InteractionContent: oneOf: - $ref: '#/components/schemas/Output_InteractionText' properties: type: const: text type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionMedia' properties: type: const: image type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionMedia' properties: type: const: audio type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionMedia' properties: type: const: video type: string required: - type type: object - $ref: '#/components/schemas/Output_InteractionMedia' properties: type: const: document type: string required: - type type: object Output_InteractionText: additionalProperties: true properties: annotations: items: true type: array text: type: string required: - text type: object Output_InteractionMedia: additionalProperties: true properties: channels: format: uint64 minimum: 0 type: - integer - 'null' data: type: - string - 'null' metadata: true mime_type: type: - string - 'null' resolution: type: - string - 'null' sample_rate: format: uint64 minimum: 0 type: - integer - 'null' uri: type: - string - 'null' type: object securitySchemes: bearer: scheme: bearer type: http anthropicKey: in: header name: x-api-key type: apiKey googleKey: in: header name: x-goog-api-key type: apiKey queryKey: in: query name: key type: apiKey ```` ## Related topics - [DELETE /v1/interactions/{id}](https://gproxy.leenhawk.com/api-reference/forwarding/delete-v1interactions.md) - [POST /v1/interactions/{id}/cancel](https://gproxy.leenhawk.com/api-reference/forwarding/post-v1interactions-cancel.md) - [GET /v1beta/interactions/{id}](https://gproxy.leenhawk.com/api-reference/forwarding/get-v1betainteractions.md) - [GET /v1/files/{id}](https://gproxy.leenhawk.com/api-reference/forwarding/get-v1files-1.md) - [GET /v1/models/{id}](https://gproxy.leenhawk.com/api-reference/forwarding/get-v1models-1.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.