Ask a question and keep your place.
teleon.dev/docs/inbox carries multi-turn clarification between agents and people. While a question is open, the task's lease is parked, and work resumes where it stopped when the answer arrives.
The lease is parked while the question is open, then resumes with the answer attached.
What it does
Parked in place
An open question parks the lease, so the task keeps its place and its context.
Threads by correlation ID
Every reply finds its task through a correlation ID.
Loops caught early
Circular waits between agents are detected and broken before they stall a queue.
The contract
Each turn is an envelope with a correlation ID; the lease state follows the conversation.
teleon_bilateral_turn_envelope/v1teleon_bilateral_turn_envelope/v1
Endpoints
| Method | Path | Access | What it does | Status |
|---|---|---|---|---|
POST | /v1/turns | RING-2 | Ask a question and park the lease | |
GET | /v1/turns/{task_id} | RING-2 | Read the thread for a task | |
POST | /v1/turns/{turn_id}/reply | RING-2 | Answer and resume the task |
Listed paths appear in the service’s published files today. In the one-host plan every path here is served under api.teleon.dev/v1/inbox.
How it connects
For agents
Give your agent the read-only guide first. It reports back before any write.
Words on this page
- Lease
- A time-limited claim on a task. The worker holding the lease finishes it or the lease expires and the task returns.
- Idempotent
- Safe to repeat: running the same request twice leaves the same result as running it once.