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/conversationsConversations, newest first: one user's with user_id, or every one of the company's without it (the company's own Bash shows user_id null).

Your API key, scope runtime or all. On the card: ask. Over HTTP it is made from the contract: fill in every value.

Request3 fields

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

user_idstringOnly this user's conversations, by your id for them. Absent: every conversation of your company.

Type: string

Answers 2002 fields

dataobject[]The items on this page.

idstringThe conversation (conv_...).

Example: conv_8f2k

object"conversation"Always conversation.

Type: "conversation"

user_idstring | nullYour id for the user; null on your company's own Bash, and on an agent's conversation over A2A that names no user.

Type: string | null

deployment_idstring | nullThe deployment that answers it (dep_...); null when it has none.

Type: string | null

deployment_versioninteger | nullThe version of the deployment it runs on: in test mode the one it started on, in live mode the one live at its last message. Null with no deployment.

Type: integer | null

status"idle" | "replying" | "working" | "waiting"What the conversation is doing. idle: nothing. replying: Bash is writing its reply. working: work Bash started is running. waiting: Bash waits on an approval, a question or a call to one of your tools.

Type: "idle" | "replying" | "working" | "waiting"

metadatamap of stringYour labels, as you sent them; empty when you sent none.

Type: map of string

created_atstringWhen it started, as an ISO 8601 time.

Type: string

last_active_atstringWhen a message or its work last changed it, 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" \  -H "Authorization: Bearer $VESTRA_API_KEY"