CEceledon-solutions
Sessions

Read the session's conversation

Changed on

The transcript: your prompts, the agent's replies and reasoning, and every tool it used with the result.

source tells you where the answer came from. live is the running agent's own copy and is current. persisted is the saved copy, which is written when a run ends — so it is complete for a finished run but behind for a running one. none means there is no conversation yet.

Entries are ordered oldest to newest and limit takes the most recent, which is usually what you want after a run.

get/api/v2/projects/{projectId}/sessions/{sessionId}/messages

Request

  • Base URL
    https://davinci-app.com
  • Auth
    HTTP bearer

Query parameters

limitinteger

Most recent entries to return.

Response

The conversation.

sessionIdstring uuid required
taskIdstring required
source'live' | 'persisted' | 'none' required

Where the answer came from. live is current; persisted is the copy saved when a run ended, and so lags a run in progress.

status'no_session' | 'project_not_running' | 'idle' | 'starting' | 'running' | 'paused' | 'completed' | 'failed' | 'unknown' required
  • no_session — the machine has no record of this session; it lapsed or the project restarted. Create a new one.
  • project_not_running — the session is known but its project has unloaded.
  • idle — the session is live and no run has been started.
  • starting — a run is being set up.
  • running — a run is in progress.
  • paused — a run was stopped and can be continued with a new prompt.
  • completed — the run finished.
  • failed — the run ended in an error. agent.error says why, as does the transcript.
  • unknown — the machine could not be reached for this field. Retry; anything else in the same response is still valid.

paused, completed, and failed are terminal for a run.

entryCountinteger required

Entries in the whole conversation, not just the returned window.

Changes

  • v267c8b8616dbbRevision changes
    • info

      the response property const value false was added for the status

    • info

      the response property const value false was added for the status

    • info

      the response property const value false was added for the status

    • info

      the response property const value false was added for the status

    • info

      the response property const value false was added for the status

    • info

      the response property const value false was added for the status

  • v248948af37797Revision changes
    • info

      endpoint added