Sign in
v3
Fi3

Create, update, or read a fi3 thread

Handle fi3 thread requests.

post/v3/teams/{team_id}/users/{user_id}/fi3/thread

Path parameters

team_idstring required
user_idstring required

Request body

method'upsert' | 'delete' | 'stop' | 'marimo_start' | 'update_metadata' | 'show_artifacts' | 'warm_sandbox' required

Operation method

thread_idstring

Thread id to use for the agent

user_messagestring

User message to the fi agent

table_integration_idstring

Table integration id to use for the agent (DuckDB)

cube_integration_idstring

Cube integration id to use for the agent

application_contextstring nullable

Additional context about the application state

modelstring nullable

Claude model to use (e.g., 'sonnet', 'opus')

doc_idstring nullable

ID of the doc currently being edited by the user

doc_yaml_contentstring nullable

Current doc.yaml content from frontend Doc view to mount in sandbox

thread_titlestring nullable

New title for the thread

doc_discovery_mode'preload_recent' | 'preload_all' | 'lazy'

Document discovery mode for loading team docs

preload_doc_idsstring[]

Optional explicit list of doc IDs to pre-load

max_preload_docsinteger

Maximum number of docs to pre-load (default 50)

max_filesinteger

Maximum number of files to return with download URLs

app_eventsobject[]

Application events like file uploads

project_idstring nullable

Project ID to associate the thread with

sandboxTier'small' | 'medium' | 'large'

Response

Success

successboolean required

Whether the background execution was successful

messagestring

Message from the background execution

{"stackTrail":"components:schemas:Fi2BackgroundResponse:properties:result:anyOf","oasType":"schema","type":"unknown","title":"Result","description":"Structured result from Claude Code execution","nullable":true}
raw_outputstring

Raw output from Claude Code

errorstring nullable

Error message if execution failed

execution_timenumber

Execution time in seconds

sandbox_idstring nullable

E2B sandbox ID used for execution

html_filesobject[]

Generated files (HTML and Python) with filename, content, and file_type

Changes

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