Get Conductor session

Read a Conductor conversation with all of its messages.

GEThttps://api.tried.com.au/conductor/sessions/{id}

Returns one conversation with its attachments and full message history.

Request#

Field	Type	Required	Description
`id`	string	Yes	Conversation ID, for example `conductor_1d3f5a7c9e2b4d6f8a0c2e4b`.

Example request#

curl https://api.tried.com.au/conductor/sessions/conductor_1d3f5a7c9e2b4d6f8a0c2e4b \
  -H "Authorization: Bearer $TRIED_API_KEY"

const res = await fetch("https://api.tried.com.au/conductor/sessions/conductor_1d3f5a7c9e2b4d6f8a0c2e4b", {
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const session = await res.json();

import os, requests

res = requests.get(
    "https://api.tried.com.au/conductor/sessions/conductor_1d3f5a7c9e2b4d6f8a0c2e4b",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
session = res.json()

Response#

200 OK

{
  "session_id": "conductor_1d3f5a7c9e2b4d6f8a0c2e4b",
  "title": "Build a dashboard of call volume and latency by agent",
  "user_id": null,
  "attachments": [
    {
      "type": "agent",
      "id": "agent_4b7e2c9a1f3d5e8b0c6a2d1f"
    }
  ],
  "message_count": 2,
  "messages": [
    {
      "role": "user",
      "content": "Build a dashboard of call volume and latency by agent",
      "attachments": [],
      "timestamp": 1792395060000
    },
    {
      "role": "assistant",
      "content": "I built the dashboard \"call volume and latency by agent\" with 3 charts. Open Analytics to see it.",
      "action": "build_dashboard",
      "result": {
        "type": "dashboard",
        "dashboard_id": "dash_6e1a9c3f5b7d2e4a8c0f1b3d",
        "name": "call volume and latency by agent",
        "charts": 3
      },
      "mode": "mock",
      "credits": 1,
      "credit_source": "free_workspace",
      "timestamp": 1792395060000
    }
  ],
  "created_timestamp": 1792395000000,
  "last_modification_timestamp": 1792395060000
}

Field	Type	Description
`session_id`	string	Conversation ID, prefixed `conductor_`.
`user_id`	string or null	Dashboard user who owns it. `null` when created with an API key.
`attachments`	object[]	Context attached to the conversation.
`message_count`	integer	User and assistant messages so far.
`messages`	object[]	User messages have `content`, `attachments` added with that message and `timestamp`. Assistant messages have `content`, `action`, `result`, `mode` (`llm` or `mock`), `credits`, `credit_source` and `timestamp`.
`created_timestamp`, `last_modification_timestamp`	integer	Unix ms.

Errors#

Status	When
`401`	Missing or invalid API key.
`403`	The key's IP allowlist or scopes reject the request. This route needs the `admin` scope.
`404`	No conversation with that ID in the workspace: `Conversation not found`.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.

Retell compatibility#

Retell's public API reference has no Conductor endpoints, so this route has no Retell SDK equivalent.