Conversations

Ask Bash in a conversation, follow its reply as it happens, and stop it.

Send Authorization: Bearer vk_test_... on every call. Every route of Conversations.

GET/v1/conversations/{conversation_id}/messagesThe conversation, paged: your messages, Bash's replies, and summaries of the work it did.

Your API key, or a session's token, scope runtime or all. On the card: ask. Over HTTP it is made from the contract: fill in each {…} and every value.

Request3 fields

Path

conversation_idstringrequiredThe conversation's id (conv_...).

Type: string

Query

limitintegerHow many items per page, 1 to 100. Default 20.

Type: integer

cursorstringWhere to go on from: the next_cursor of the page before, unchanged. Absent: the first page.

Type: string

Answers 2002 fields

dataobject[]The items on this page.

idstringThe line.

Type: string

object"conversation.message"Always conversation.message.

Type: "conversation.message"

turn_idstringThe turn it belongs to (turn_...).

Type: string

role"user" | "assistant"user: what was sent. assistant: what Bash said back.

Type: "user" | "assistant"

textstringThe words. A send of tool results reads "Tool results:" and the tools it answered.

Type: string

workobject[]On Bash's line: the work its reply started.

task_idstringThe task (task_...).

Type: string

titlestring | nullWhat the work is; null until Bash names it.

Type: string | null

created_atstringWhen it was said, as an ISO 8601 time.

Type: string

next_cursorstring | nullSend it as cursor for the next page; null on the last page.

Type: string | null

HTTP

No sample in your language for this route, so here it is over HTTP.

curl "$VESTRA_BASE_URL/v1/conversations/{conversation_id}/messages" \  -H "Authorization: Bearer $VESTRA_API_KEY"