API reference

The API is available to organizations integrating Agent workflows into existing systems. This public page documents stable concepts; authentication, environment URLs, and full schemas are provided during integration.

Core objects

• Thread: a recoverable Agent session.
• Task: work currently running or waiting for approval.
• State: topics, sources, outline, sections, and review history.
• Checkpoint: a persisted point that can pause and resume.

Typical sequence

1. Create a Thread with a research direction.
2. Subscribe to events or poll task state.
3. Submit topic or outline approval when state is waiting_for_human.
4. Continue and receive section and review results.
5. Persist the Thread ID for recovery and audit.

Integration requirements

• Send tenant and user identity with every request.
• Use idempotency keys for retried writes.
• Recover a disconnected stream through task state rather than creating duplicate work.
• Never log full manuscripts, private sources, or credentials.

Contact sales@seelescholar.com for API access.