1353 lines
34 KiB
YAML
1353 lines
34 KiB
YAML
servers:
|
|
- url: https://api.letta.com
|
|
description: Letta Cloud
|
|
x-fern-server-name: Letta Cloud
|
|
- url: http://localhost:8283
|
|
description: Self-hosted
|
|
x-fern-server-name: Self-hosted
|
|
|
|
components:
|
|
schemas:
|
|
UpdateMCPServerRequest:
|
|
x-fern-ignore: true
|
|
CreateMCPServerRequest:
|
|
x-fern-ignore: true
|
|
StdioMCPServer:
|
|
x-fern-ignore: true
|
|
SSEMCPServer:
|
|
x-fern-ignore: true
|
|
StreamableHTTPMCPServer:
|
|
x-fern-ignore: true
|
|
|
|
paths:
|
|
/v1/mcp-servers/:
|
|
get:
|
|
x-fern-ignore: true
|
|
post:
|
|
x-fern-ignore: true
|
|
/v1/mcp-servers/{mcp_server_id}:
|
|
get:
|
|
x-fern-ignore: true
|
|
patch:
|
|
x-fern-ignore: true
|
|
delete:
|
|
x-fern-ignore: true
|
|
/v1/mcp-servers/{mcp_server_id}/tools:
|
|
get:
|
|
x-fern-ignore: true
|
|
/v1/mcp-servers/{mcp_server_id}/tools/{tool_id}:
|
|
get:
|
|
x-fern-ignore: true
|
|
/v1/mcp-servers/{mcp_server_id}/tools/{tool_id}/run:
|
|
post:
|
|
x-fern-ignore: true
|
|
/v1/mcp-servers/{mcp_server_id}/refresh:
|
|
post:
|
|
x-fern-ignore: true
|
|
patch:
|
|
x-fern-ignore: true
|
|
/v1/mcp-servers/connect/{mcp_server_id}:
|
|
post:
|
|
x-fern-ignore: true
|
|
/v1/tools/{tool_id}:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- tools
|
|
x-fern-sdk-method-name: retrieve
|
|
delete:
|
|
x-fern-sdk-group-name:
|
|
- tools
|
|
x-fern-sdk-method-name: delete
|
|
responses:
|
|
'200':
|
|
description: Successful Response
|
|
content:
|
|
application/json:
|
|
example:
|
|
success: true
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- tools
|
|
x-fern-sdk-method-name: modify
|
|
/v1/tools/:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- tools
|
|
x-fern-sdk-method-name: list
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- tools
|
|
x-fern-sdk-method-name: create
|
|
put:
|
|
x-fern-sdk-group-name:
|
|
- tools
|
|
x-fern-sdk-method-name: upsert
|
|
/v1/tools/count:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- tools
|
|
x-fern-sdk-method-name: count
|
|
/v1/tools/add-base-tools:
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- tools
|
|
x-fern-sdk-method-name: upsert_base_tools
|
|
/v1/tools/mcp/oauth/callback/{session_id}:
|
|
get:
|
|
x-fern-ignore: true
|
|
/v1/tools/mcp/servers:
|
|
get:
|
|
summary: "List MCP Servers"
|
|
put:
|
|
summary: "Add MCP Server To Config"
|
|
/v1/tools/mcp/servers/{mcp_server_name}/tools:
|
|
get:
|
|
summary: "List MCP Tools By Server"
|
|
/v1/tools/mcp/servers/{mcp_server_name}/tools/{tool_name}/execute:
|
|
post:
|
|
x-fern-ignore: true
|
|
/v1/tools/mcp/servers/{mcp_server_name}/{mcp_tool_name}:
|
|
post:
|
|
summary: "Add MCP Tool"
|
|
/v1/tools/mcp/servers/{mcp_server_name}/resync:
|
|
post:
|
|
x-fern-ignore: true
|
|
/v1/tools/mcp/servers/{mcp_server_name}:
|
|
patch:
|
|
summary: "Update MCP Server"
|
|
delete:
|
|
summary: "Delete MCP Server From Config"
|
|
/v1/tools/mcp/servers/test:
|
|
post:
|
|
x-fern-availability: deprecated
|
|
summary: "Test MCP Server"
|
|
/v1/tools/mcp/servers/connect:
|
|
post:
|
|
x-fern-streaming:
|
|
format: sse
|
|
summary: "Connect MCP Server"
|
|
responses:
|
|
'200':
|
|
content:
|
|
text/event-stream:
|
|
schema:
|
|
x-fern-type-name: StreamingResponse
|
|
type: object
|
|
properties:
|
|
event:
|
|
type: string
|
|
enum:
|
|
- connection_attempt
|
|
- success
|
|
- error
|
|
- oauth_required
|
|
- authorization_url
|
|
- waiting_for_auth
|
|
message:
|
|
type: string
|
|
tools:
|
|
$ref: '#/components/schemas/MCPTool'
|
|
required:
|
|
- event
|
|
/v1/sources/{source_id}:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- sources
|
|
x-fern-sdk-method-name: retrieve
|
|
delete:
|
|
x-fern-sdk-group-name:
|
|
- sources
|
|
x-fern-sdk-method-name: delete
|
|
responses:
|
|
'200':
|
|
description: Successful Response
|
|
content:
|
|
application/json:
|
|
example:
|
|
success: true
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- sources
|
|
x-fern-sdk-method-name: modify
|
|
/v1/sources/name/{source_name}:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- sources
|
|
x-fern-sdk-method-name: retrieve_by_name
|
|
/v1/sources/:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- sources
|
|
x-fern-sdk-method-name: list
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- sources
|
|
x-fern-sdk-method-name: create
|
|
/v1/sources/count:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- sources
|
|
x-fern-sdk-method-name: count
|
|
/v1/sources/{source_id}/upload:
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- sources
|
|
- files
|
|
x-fern-sdk-method-name: upload
|
|
/v1/sources/{source_id}/passages:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- sources
|
|
- passages
|
|
x-fern-sdk-method-name: list
|
|
/v1/sources/{source_id}/files:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- sources
|
|
- files
|
|
x-fern-sdk-method-name: list
|
|
/v1/sources/{source_id}/{file_id}:
|
|
delete:
|
|
x-fern-sdk-group-name:
|
|
- sources
|
|
- files
|
|
x-fern-sdk-method-name: delete
|
|
/v1/folders/{folder_id}:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- folders
|
|
x-fern-sdk-method-name: retrieve
|
|
delete:
|
|
x-fern-sdk-group-name:
|
|
- folders
|
|
x-fern-sdk-method-name: delete
|
|
responses:
|
|
'200':
|
|
description: Successful Response
|
|
content:
|
|
application/json:
|
|
example:
|
|
success: true
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- folders
|
|
x-fern-sdk-method-name: modify
|
|
/v1/folders/name/{folder_name}:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- folders
|
|
x-fern-sdk-method-name: retrieve_by_name
|
|
/v1/folders/:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- folders
|
|
x-fern-sdk-method-name: list
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- folders
|
|
x-fern-sdk-method-name: create
|
|
/v1/folders/count:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- folders
|
|
x-fern-sdk-method-name: count
|
|
/v1/folders/{folder_id}/upload:
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- folders
|
|
- files
|
|
x-fern-sdk-method-name: upload
|
|
/v1/folders/{folder_id}/passages:
|
|
get:
|
|
summary: List Passages For Folder
|
|
x-fern-sdk-group-name:
|
|
- folders
|
|
- passages
|
|
x-fern-sdk-method-name: list
|
|
/v1/folders/{folder_id}/files:
|
|
get:
|
|
summary: List Files For Folder
|
|
x-fern-sdk-group-name:
|
|
- folders
|
|
- files
|
|
x-fern-sdk-method-name: list
|
|
/v1/folders/{folder_id}/{file_id}:
|
|
delete:
|
|
x-fern-sdk-group-name:
|
|
- folders
|
|
- files
|
|
x-fern-sdk-method-name: delete
|
|
/v1/folders/{folder_id}/agents:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- folders
|
|
- agents
|
|
x-fern-sdk-method-name: list
|
|
/v1/agents/:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
x-fern-sdk-method-name: list
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
x-fern-sdk-method-name: create
|
|
/v1/agents/{agent_id}:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
x-fern-sdk-method-name: retrieve
|
|
delete:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
x-fern-sdk-method-name: delete
|
|
responses:
|
|
'200':
|
|
description: Successful Response
|
|
content:
|
|
application/json:
|
|
example:
|
|
success: true
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
x-fern-sdk-method-name: modify
|
|
/v1/agents/count:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
x-fern-sdk-method-name: count
|
|
/v1/agents/search:
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
x-fern-sdk-method-name: search
|
|
summary: Search Agents
|
|
description: |
|
|
<Note>This endpoint is only available on Letta Cloud.</Note>
|
|
|
|
Search deployed agents.
|
|
/v1/agents/{agent_id}/context:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- context
|
|
x-fern-sdk-method-name: retrieve
|
|
/v1/agents/{agent_id}/tools:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- tools
|
|
x-fern-sdk-method-name: list
|
|
/v1/agents/{agent_id}/tools/attach/{tool_id}:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- tools
|
|
x-fern-sdk-method-name: attach
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: tool_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/agents/{agent_id}/tools/detach/{tool_id}:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- tools
|
|
x-fern-sdk-method-name: detach
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: tool_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/agents/{agent_id}/tools/approval/{tool_name}:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- tools
|
|
x-fern-sdk-method-name: modify_approval
|
|
/v1/agents/{agent_id}/sources:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- sources
|
|
x-fern-sdk-method-name: list
|
|
/v1/agents/{agent_id}/core-memory:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- core_memory
|
|
x-fern-sdk-method-name: retrieve
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/agents/{agent_id}/core-memory/blocks:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- blocks
|
|
x-fern-sdk-method-name: list
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/agents/{agent_id}/core-memory/blocks/attach/{block_id}:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- blocks
|
|
x-fern-sdk-method-name: attach
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: block_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/agents/{agent_id}/core-memory/blocks/detach/{block_id}:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- blocks
|
|
x-fern-sdk-method-name: detach
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: block_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/agents/{agent_id}/core-memory/blocks/{block_label}:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- blocks
|
|
x-fern-sdk-method-name: retrieve
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: block_label
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- blocks
|
|
x-fern-sdk-method-name: modify
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: block_label
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/agents/{agent_id}/archival-memory:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- passages
|
|
x-fern-sdk-method-name: list
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- passages
|
|
x-fern-sdk-method-name: create
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/agents/{agent_id}/archival-memory/{memory_id}:
|
|
delete:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- passages
|
|
x-fern-sdk-method-name: delete
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: memory_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
responses:
|
|
'200':
|
|
description: Successful Response
|
|
content:
|
|
application/json:
|
|
example:
|
|
success: true
|
|
/v1/agents/{agent_id}/archival-memory/search:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- passages
|
|
x-fern-sdk-method-name: search
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/agents/{agent_id}/reset-messages:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- messages
|
|
x-fern-sdk-method-name: reset
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/agents/{agent_id}/messages:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- messages
|
|
x-fern-sdk-method-name: list
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- messages
|
|
x-fern-sdk-method-name: create
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
example:
|
|
messages:
|
|
- role: user
|
|
content:
|
|
- type: text
|
|
text: "The sky above the port was the color of television, tuned to a dead channel."
|
|
/v1/agents/{agent_id}/messages/{message_id}:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- messages
|
|
x-fern-sdk-method-name: modify
|
|
/v1/agents/{agent_id}/messages/async:
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- messages
|
|
x-fern-sdk-method-name: create_async
|
|
/v1/agents/{agent_id}/messages/stream:
|
|
post:
|
|
x-fern-streaming:
|
|
format: sse
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- messages
|
|
x-fern-sdk-method-name: create_stream
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
example:
|
|
messages:
|
|
- role: user
|
|
content:
|
|
- type: text
|
|
text: "The sky above the port was the color of television, tuned to a dead channel."
|
|
responses:
|
|
'200':
|
|
content:
|
|
text/event-stream:
|
|
schema:
|
|
x-fern-type-name: LettaStreamingResponse
|
|
oneOf:
|
|
- $ref: '#/components/schemas/SystemMessage'
|
|
- $ref: '#/components/schemas/UserMessage'
|
|
- $ref: '#/components/schemas/ReasoningMessage'
|
|
- $ref: '#/components/schemas/HiddenReasoningMessage'
|
|
- $ref: '#/components/schemas/ToolCallMessage'
|
|
- $ref: '#/components/schemas/ToolReturnMessage'
|
|
- $ref: '#/components/schemas/AssistantMessage'
|
|
- $ref: '#/components/schemas/ApprovalRequestMessage'
|
|
- $ref: '#/components/schemas/ApprovalResponseMessage'
|
|
- $ref: '#/components/schemas/SummaryMessage'
|
|
- $ref: '#/components/schemas/EventMessage'
|
|
- $ref: '#/components/schemas/LettaPing'
|
|
- $ref: '#/components/schemas/LettaErrorMessage'
|
|
- $ref: '#/components/schemas/LettaStopReason'
|
|
- $ref: '#/components/schemas/LettaUsageStatistics'
|
|
/v1/agents/{agent_id}/messages/cancel:
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- messages
|
|
x-fern-sdk-method-name: cancel
|
|
/v1/agents/{agent_id}/messages/preview-raw-payload:
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- messages
|
|
x-fern-sdk-method-name: preview
|
|
/v1/agents/messages/search:
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- messages
|
|
x-fern-sdk-method-name: search
|
|
/v1/agents/{agent_id}/summarize:
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- messages
|
|
x-fern-sdk-method-name: summarize
|
|
/v1/agents/{agent_id}/core-memory/variables:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- memory_variables
|
|
x-fern-sdk-method-name: list
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
description: |
|
|
<Note>This endpoint is only available on Letta Cloud.</Note>
|
|
|
|
Returns the memory variables associated with an agent.
|
|
/v1/agents/{agent_id}/sources/attach/{source_id}:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- sources
|
|
x-fern-sdk-method-name: attach
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: source_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/agents/{agent_id}/sources/detach/{source_id}:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- sources
|
|
x-fern-sdk-method-name: detach
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: source_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/agents/{agent_id}/folders:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- folders
|
|
x-fern-sdk-method-name: list
|
|
/v1/agents/{agent_id}/folders/attach/{folder_id}:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- folders
|
|
x-fern-sdk-method-name: attach
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: folder_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/agents/{agent_id}/folders/detach/{folder_id}:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- folders
|
|
x-fern-sdk-method-name: detach
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: folder_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/agents/{agent_id}/archives/attach/{archive_id}:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- archives
|
|
x-fern-sdk-method-name: attach
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: archive_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/agents/{agent_id}/archives/detach/{archive_id}:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- archives
|
|
x-fern-sdk-method-name: detach
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: archive_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/agents/{agent_id}/identities/attach/{identity_id}:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- identities
|
|
x-fern-sdk-method-name: attach
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: identity_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/agents/{agent_id}/identities/detach/{identity_id}:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- identities
|
|
x-fern-sdk-method-name: detach
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: identity_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/agents/import:
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
x-fern-sdk-method-name: import_file
|
|
/v1/agents/{agent_id}/export:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
x-fern-sdk-method-name: export_file
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/agents/{agent_id}/groups:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- groups
|
|
x-fern-sdk-method-name: list
|
|
parameters:
|
|
- name: agent_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/models/:
|
|
get:
|
|
summary: List LLM Models
|
|
x-fern-sdk-group-name:
|
|
- models
|
|
x-fern-sdk-method-name: list
|
|
/v1/models/embedding:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- models
|
|
- embeddings
|
|
x-fern-sdk-method-name: list
|
|
/v1/blocks/:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- blocks
|
|
x-fern-sdk-method-name: list
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- blocks
|
|
x-fern-sdk-method-name: create
|
|
/v1/blocks/{block_id}:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- blocks
|
|
x-fern-sdk-method-name: retrieve
|
|
delete:
|
|
x-fern-sdk-group-name:
|
|
- blocks
|
|
x-fern-sdk-method-name: delete
|
|
responses:
|
|
'200':
|
|
description: Successful Response
|
|
content:
|
|
application/json:
|
|
example:
|
|
success: true
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- blocks
|
|
x-fern-sdk-method-name: modify
|
|
/v1/blocks/count:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- blocks
|
|
x-fern-sdk-method-name: count
|
|
/v1/blocks/{block_id}/agents:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- blocks
|
|
- agents
|
|
x-fern-sdk-method-name: list
|
|
/v1/blocks/{block_id}/identities/attach/{identity_id}:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- blocks
|
|
- identities
|
|
x-fern-sdk-method-name: attach
|
|
parameters:
|
|
- name: block_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: identity_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/blocks/{block_id}/identities/detach/{identity_id}:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- blocks
|
|
- identities
|
|
x-fern-sdk-method-name: detach
|
|
parameters:
|
|
- name: block_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
- name: identity_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/jobs/:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- jobs
|
|
x-fern-sdk-method-name: list
|
|
/v1/jobs/active:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- jobs
|
|
x-fern-sdk-method-name: listActive
|
|
/v1/jobs/{job_id}:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- jobs
|
|
x-fern-sdk-method-name: retrieve
|
|
delete:
|
|
x-fern-sdk-group-name:
|
|
- jobs
|
|
x-fern-sdk-method-name: delete
|
|
/v1/runs/:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- runs
|
|
x-fern-sdk-method-name: list
|
|
/v1/runs/active:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- runs
|
|
x-fern-sdk-method-name: list_active
|
|
/v1/runs/{run_id}:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- runs
|
|
x-fern-sdk-method-name: retrieve
|
|
delete:
|
|
x-fern-sdk-group-name:
|
|
- runs
|
|
x-fern-sdk-method-name: delete
|
|
/v1/runs/{run_id}/messages:
|
|
get:
|
|
summary: List Messages For Run
|
|
x-fern-sdk-group-name:
|
|
- runs
|
|
- messages
|
|
x-fern-sdk-method-name: list
|
|
/v1/runs/{run_id}/usage:
|
|
get:
|
|
summary: Retrieve Usage For Run
|
|
x-fern-sdk-group-name:
|
|
- runs
|
|
- usage
|
|
x-fern-sdk-method-name: retrieve
|
|
/v1/runs/{run_id}/steps:
|
|
get:
|
|
summary: List Steps For Run
|
|
x-fern-sdk-group-name:
|
|
- runs
|
|
- steps
|
|
x-fern-sdk-method-name: list
|
|
/v1/runs/{run_id}/stream:
|
|
post:
|
|
x-fern-streaming:
|
|
format: sse
|
|
x-fern-sdk-group-name:
|
|
- runs
|
|
x-fern-sdk-method-name: stream
|
|
responses:
|
|
'200':
|
|
content:
|
|
text/event-stream:
|
|
schema:
|
|
$ref: '#/components/schemas/LettaStreamingResponse'
|
|
/v1/health/:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- health
|
|
x-fern-sdk-method-name: check
|
|
/v1/templates/{project}/{template_version}/agents:
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- templates
|
|
- agents
|
|
x-fern-sdk-method-name: create
|
|
/v1/tags/:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- tags
|
|
x-fern-sdk-method-name: list
|
|
/v1/providers/:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- providers
|
|
x-fern-sdk-method-name: list
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- providers
|
|
x-fern-sdk-method-name: create
|
|
/v1/providers/{provider_id}:
|
|
delete:
|
|
x-fern-sdk-group-name:
|
|
- providers
|
|
x-fern-sdk-method-name: delete
|
|
responses:
|
|
'200':
|
|
description: Successful Response
|
|
content:
|
|
application/json:
|
|
example:
|
|
success: true
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- providers
|
|
x-fern-sdk-method-name: modify
|
|
/v1/providers/check:
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- providers
|
|
x-fern-sdk-method-name: check
|
|
/v1/steps/:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- steps
|
|
x-fern-sdk-method-name: list
|
|
/v1/steps/{step_id}:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- steps
|
|
x-fern-sdk-method-name: retrieve
|
|
/v1/steps/{step_id}/feedback:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- steps
|
|
- feedback
|
|
x-fern-sdk-method-name: create
|
|
/v1/steps/{step_id}/metrics:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- steps
|
|
- metrics
|
|
x-fern-sdk-method-name: retrieve
|
|
/v1/steps/{step_id}/trace:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- steps
|
|
- trace
|
|
x-fern-sdk-method-name: retrieve
|
|
/v1/steps/{step_id}/messages:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- steps
|
|
- messages
|
|
x-fern-sdk-method-name: list
|
|
/v1/identities/:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- identities
|
|
x-fern-sdk-method-name: list
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- identities
|
|
x-fern-sdk-method-name: create
|
|
put:
|
|
x-fern-sdk-group-name:
|
|
- identities
|
|
x-fern-sdk-method-name: upsert
|
|
/v1/identities/{identity_id}:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- identities
|
|
x-fern-sdk-method-name: retrieve
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- identities
|
|
x-fern-sdk-method-name: modify
|
|
delete:
|
|
x-fern-sdk-group-name:
|
|
- identities
|
|
x-fern-sdk-method-name: delete
|
|
responses:
|
|
'200':
|
|
description: Successful Response
|
|
content:
|
|
application/json:
|
|
example:
|
|
success: true
|
|
/v1/identities/count:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- identities
|
|
x-fern-sdk-method-name: count
|
|
/v1/identities/{identity_id}/properties:
|
|
put:
|
|
summary: Upsert Properties For Identity
|
|
x-fern-sdk-group-name:
|
|
- identities
|
|
- properties
|
|
x-fern-sdk-method-name: upsert
|
|
/v1/identities/{identity_id}/agents:
|
|
get:
|
|
summary: List Agents For Identity
|
|
x-fern-sdk-group-name:
|
|
- identities
|
|
- agents
|
|
x-fern-sdk-method-name: list
|
|
/v1/identities/{identity_id}/blocks:
|
|
get:
|
|
summary: List Blocks For Identity
|
|
x-fern-sdk-group-name:
|
|
- identities
|
|
- blocks
|
|
x-fern-sdk-method-name: list
|
|
/v1/groups/:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- groups
|
|
x-fern-sdk-method-name: list
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- groups
|
|
x-fern-sdk-method-name: create
|
|
/v1/groups/{group_id}:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- groups
|
|
x-fern-sdk-method-name: retrieve
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- groups
|
|
x-fern-sdk-method-name: modify
|
|
delete:
|
|
x-fern-sdk-group-name:
|
|
- groups
|
|
x-fern-sdk-method-name: delete
|
|
responses:
|
|
'200':
|
|
description: Successful Response
|
|
content:
|
|
application/json:
|
|
example:
|
|
success: true
|
|
/v1/groups/count:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- groups
|
|
x-fern-sdk-method-name: count
|
|
/v1/groups/{group_id}/reset-messages:
|
|
patch:
|
|
summary: Reset Messages For Group
|
|
x-fern-sdk-group-name:
|
|
- groups
|
|
- messages
|
|
x-fern-sdk-method-name: reset
|
|
parameters:
|
|
- name: group_id
|
|
in: path
|
|
required: true
|
|
schema:
|
|
type: string
|
|
/v1/groups/{group_id}/messages:
|
|
get:
|
|
summary: List Messages For Group
|
|
x-fern-sdk-group-name:
|
|
- groups
|
|
- messages
|
|
x-fern-sdk-method-name: list
|
|
post:
|
|
summary: Send Message To Group
|
|
x-fern-sdk-group-name:
|
|
- groups
|
|
- messages
|
|
x-fern-sdk-method-name: create
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
example:
|
|
messages:
|
|
- role: user
|
|
content:
|
|
- type: text
|
|
text: "The sky above the port was the color of television, tuned to a dead channel."
|
|
/v1/groups/{group_id}/messages/{message_id}:
|
|
patch:
|
|
summary: Modify Message For Group
|
|
x-fern-sdk-group-name:
|
|
- groups
|
|
- messages
|
|
x-fern-sdk-method-name: modify
|
|
/v1/groups/{group_id}/messages/stream:
|
|
post:
|
|
summary: Stream Message To Group
|
|
x-fern-streaming:
|
|
format: sse
|
|
x-fern-sdk-group-name:
|
|
- groups
|
|
- messages
|
|
x-fern-sdk-method-name: create_stream
|
|
requestBody:
|
|
content:
|
|
application/json:
|
|
example:
|
|
messages:
|
|
- role: user
|
|
content:
|
|
- type: text
|
|
text: "The sky above the port was the color of television, tuned to a dead channel."
|
|
responses:
|
|
'200':
|
|
content:
|
|
text/event-stream:
|
|
schema:
|
|
x-fern-type-name: LettaStreamingResponse
|
|
oneOf:
|
|
- $ref: '#/components/schemas/SystemMessage'
|
|
- $ref: '#/components/schemas/UserMessage'
|
|
- $ref: '#/components/schemas/ReasoningMessage'
|
|
- $ref: '#/components/schemas/ToolCallMessage'
|
|
- $ref: '#/components/schemas/ToolReturnMessage'
|
|
- $ref: '#/components/schemas/AssistantMessage'
|
|
- $ref: '#/components/schemas/SummaryMessage'
|
|
- $ref: '#/components/schemas/EventMessage'
|
|
- $ref: '#/components/schemas/LettaUsageStatistics'
|
|
/v1/messages/batches:
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- batches
|
|
x-fern-sdk-method-name: create
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- batches
|
|
x-fern-sdk-method-name: list
|
|
/v1/messages/batches/{batch_id}:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- batches
|
|
x-fern-sdk-method-name: retrieve
|
|
/v1/messages/batches/{batch_id}/cancel:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- batches
|
|
x-fern-sdk-method-name: cancel
|
|
/v1/messages/batches/{batch_id}/messages:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- batches
|
|
- messages
|
|
x-fern-sdk-method-name: list
|
|
/v1/chat/completions:
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- chat
|
|
- completions
|
|
x-fern-sdk-method-name: create
|
|
/v1/embeddings/total_storage_size:
|
|
get:
|
|
x-fern-ignore: true
|
|
/v1/voice-beta/{agent_id}/chat/completions:
|
|
get:
|
|
x-fern-ignore: true
|
|
/v1/_internal_templates/groups:
|
|
post:
|
|
x-fern-ignore: true
|
|
/v1/_internal_templates/deployment/{deployment_id}:
|
|
get:
|
|
x-fern-ignore: true
|
|
delete:
|
|
x-fern-ignore: true
|
|
/v1/_internal_templates/agents:
|
|
post:
|
|
x-fern-ignore: true
|
|
/v1/_internal_templates/blocks:
|
|
post:
|
|
x-fern-ignore: true
|
|
/v1/_internal_templates/blocks/batch:
|
|
post:
|
|
x-fern-ignore: true
|
|
/v1/_internal_runs/:
|
|
get:
|
|
x-fern-ignore: true
|
|
/v1/_internal_blocks/:
|
|
get:
|
|
x-fern-ignore: true
|
|
post:
|
|
x-fern-ignore: true
|
|
/v1/_internal_blocks/{block_id}:
|
|
delete:
|
|
x-fern-ignore: true
|
|
/v1/_internal_blocks/{block_id}/agents:
|
|
get:
|
|
x-fern-ignore: true
|
|
/v1/_internal_agents/{agent_id}/core-memory/blocks/{block_label}:
|
|
patch:
|
|
x-fern-ignore: true
|
|
/v1/projects:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- projects
|
|
x-fern-sdk-method-name: list
|
|
/v1/client-side-access-tokens:
|
|
post:
|
|
x-fern-sdk-group-name:
|
|
- client_side_access_tokens
|
|
x-fern-sdk-method-name: create
|
|
/v1/client-side-access-tokens/{token}:
|
|
delete:
|
|
x-fern-sdk-group-name:
|
|
- client_side_access_tokens
|
|
x-fern-sdk-method-name: delete
|
|
/v1/templates:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- templates
|
|
x-fern-sdk-method-name: list
|
|
/v1/agents/{agent_id}/files/{file_id}/close:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- files
|
|
x-fern-sdk-method-name: close
|
|
/v1/agents/{agent_id}/files/{file_id}/open:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- files
|
|
x-fern-sdk-method-name: open
|
|
/v1/agents/{agent_id}/files/close-all:
|
|
patch:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- files
|
|
x-fern-sdk-method-name: close_all
|
|
/v1/agents/{agent_id}/files:
|
|
get:
|
|
x-fern-sdk-group-name:
|
|
- agents
|
|
- files
|
|
x-fern-sdk-method-name: list
|