Workbench (v1)

Get a Workbench conversation

Retrieve a Workbench conversation, including metadata, aggregate AI usage, and the full transcript.

get/api/v1/workbench/{guid}

Request

  • Base URL: https://your-tenant.tines.com
  • URL: https://your-tenant.tines.com/api/v1/workbench/{guid}
  • Auth: one of:
    • API key in header X-User-Token
    • HTTP bearer

Path parameters

guidstring required

The GUID of the conversation to retrieve

Response

Successful response

guidstring

The conversation GUID

titlestring

The conversation title

sourcestring

The source of the conversation, for example tines or slack

conversation_typestring

The type of conversation: workbench, task_agent, chat_agent, or workbench_storyboard

source_typestring nullable

The type of the resource the conversation is linked to, for example Story, or null if it has no source

source_idinteger nullable

The ID of the resource the conversation is linked to, or null if it has no source

favoritedboolean

Whether the conversation is favorited by the user

creator_idinteger

The ID of the user or agent that created the conversation

creator_typestring

The type of entity that created the conversation: User or Agent

created_atstring

ISO 8601 timestamp when the conversation was created

updated_atstring

ISO 8601 timestamp when the conversation was last updated

tool_uses_countinteger

The total number of tool invocations performed during the conversation

credits_usedinteger

The total number of Tines AI credits consumed by the conversation

billed_costobject

The total cost of the conversation, as an object with currency (for example usd) and amount (a string formatted to two decimal places)

statusstring

The current status of the conversation: in_progress, complete, cancelled, or failed

usageobject

Aggregate model token usage. Contains input_tokens, output_tokens, cached_read_input_tokens, cached_write_input_tokens, and model_ids (array of strings)

stepsobject[]

Conversation messages including user, assistant, agent, and tool interactions

Changes

No recorded changes to this operation across all 1 revision of this API.