Skip to main content
GET
/
getConversation
Get a conversation with messages
curl --request GET \
  --url https://asteragents.com/api/getConversation \
  --header 'Authorization: Bearer <token>'
{ "id": "550e8400-e29b-41d4-a716-446655440000", "agentId": 123, "userId": "user_2ABC123DEF", "organizationId": "org_xxx", "name": "Help with quarterly report", "upstreamConversationId": null, "renderedSystemPrompt": "You are a helpful assistant...", "streamStatus": "completed", "createdAt": "2024-01-15T10:30:00.000Z", "updatedAt": "2024-01-15T10:35:00.000Z", "deletedAt": null, "messages": [ { "id": "660e8400-e29b-41d4-a716-446655440001", "role": "user", "parts": [ { "type": "text", "text": "Can you help me analyze this data?" } ] }, { "id": "660e8400-e29b-41d4-a716-446655440002", "role": "assistant", "parts": [ { "type": "text", "text": "Of course! I'd be happy to help you analyze the data." } ] } ] }

Documentation Index

Fetch the complete documentation index at: https://docs.asteragents.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

JWT token from Clerk authentication.

Must be from a user with org:admin role.

Query Parameters

​
threadId
string<uuid>
required

The UUID of the conversation thread

Example:

"550e8400-e29b-41d4-a716-446655440000"

Response

Successfully retrieved conversation

​
id
string<uuid>
required

Unique conversation identifier

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
agentId
integer
required

ID of the agent this conversation is with

Example:

123

​
userId
string
required

Clerk user ID of the conversation owner

Example:

"user_2ABC123DEF"

​
createdAt
string<date-time>
required

When the conversation was created

Example:

"2024-01-15T10:30:00.000Z"

​
updatedAt
string<date-time>
required

When the conversation was last updated

Example:

"2024-01-15T10:35:00.000Z"

​
messages
object[]
required

All messages in the conversation, ordered by creation time

​
organizationId
string | null

Organization the conversation belongs to

Example:

"org_xxx"

​
name
string | null

Conversation name/title (auto-generated or user-defined)

Example:

"Help with quarterly report"

​
upstreamConversationId
string<uuid> | null

Parent conversation ID for branched conversations

Example:

null

​
renderedSystemPrompt
string | null

The system prompt used for this conversation (for audit)

Example:

"You are a helpful assistant..."

​
streamStatus
enum<string> | null

Current streaming status

Available options:
in_progress,
completed,
stopped,
error,
timeout
Example:

"completed"

​
deletedAt
string<date-time> | null

When the conversation was soft-deleted (null if active)

Example:

null

​
isDeleted
boolean

Present and true if conversation was soft-deleted

Example:

false