Responses
The Responses API represents Plannix's stateful inference engine. Unlike traditional stateless completions, responses can be referenced, updated, compacted, and persisted across multi-step agent workflows.
POST/v1/responses
Create new response
Dispatches a prompt to the model and generates a stateful response containing text, reasoning traces, and tool calls.
| Parameter | Type | Description |
|---|---|---|
| modelrequired string | string | ID of the model to use (e.g. plannix-3.6-ultra or plannix-3.6-fast). |
| inputrequired string | array | string | array | The user instruction or conversational history. |
| reasoning_effort string (optional) | string | Constrains model thinking depth: low, medium, or high. |
cURL Requestbash
curl https://api.plannix.web.id/v1/responses \
-H "Authorization: Bearer ${PLANNIX_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"model": "plannix-3.6-ultra",
"input": "Analyze the complexity of Dijkstra algorithm",
"reasoning_effort": "high"
}'GET/v1/responses/{response_id}
Retrieve previous response
Fetches full completion details, token counts, and execution metadata for a given response ID.
cURL Requestbash
curl https://api.plannix.web.id/v1/responses/resp_883a1290 \
-H "Authorization: Bearer ${PLANNIX_API_KEY}"DELETE/v1/responses/{response_id}
Delete previous response
Permanently purges a stored response from Plannix memory and frees associated disk storage.
cURL Requestbash
curl -X DELETE https://api.plannix.web.id/v1/responses/resp_883a1290 \
-H "Authorization: Bearer ${PLANNIX_API_KEY}"POST/v1/responses/{response_id}/compact
Compact a conversation
Compresses a multi-turn conversation into a concise summary while retaining key factual decisions and code deliverables to reduce token overhead.