Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.qoder.com/llms.txt

Use this file to discover all available pages before exploring further.

POST /v1/sessions/{session_id}/turns/{turn_id}/resolve When the agent requires tool-use results during execution, this endpoint accepts the tool results and lets the agent continue processing.

Path parameters

ParameterTypeDescription
session_idstringSession ID with the sess_ prefix
turn_idstringTurn ID with the turn_ prefix

Headers

HeaderRequiredDescription
AuthorizationYesBearer $QODER_PAT
Content-TypeYesapplication/json

Request body (expected)

FieldTypeRequiredDescription
tool_resultsarrayYesList of tool execution results
tool_results[].tool_use_idstringYesCorresponding tool_use ID
tool_results[].contentstringYesResult content returned by the tool

Example request

curl -X POST https://openapi.qoder.sh/api/v1/cloud/sessions/sess_019e392c0d1e74e095d21ea4c6b41def/turns/turn_019e392c0d787ceea6bb62943f9ac3ec/resolve \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "tool_results": [
      {
        "tool_use_id": "toolu_abc123",
        "content": "Tool execution result data"
      }
    ]
  }'

Response

Current state

This endpoint returns HTTP 404 (plain text 404 page not found), indicating the route is not yet registered.

Expected success response (200 OK)

When the feature ships, the endpoint is expected to return the updated turn state or an empty response.

Errors

HTTPTypeTrigger
400invalid_request_errorMalformed request
401authentication_errorPAT invalid or expired
404not_found_errorSession or Turn does not exist / route not implemented
409conflict_errorTurn is not in a state awaiting tool results
See Errors for the full error envelope.