PATCH
/
v1
/
agents
/
{agent_id}
/
add-tool
/
{tool_id}

Authorizations

Authorization
string
headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

agent_id
string
required
tool_id
string
required

Response

200 - application/json

Representation of an agent's state. This is the state of the agent at a given time, and is persisted in the DB backend. The state has all the information needed to recreate a persisted agent.

Parameters: id (str): The unique identifier of the agent. name (str): The name of the agent (must be unique to the user). created_at (datetime): The datetime the agent was created. message_ids (List[str]): The ids of the messages in the agent's in-context memory. memory (Memory): The in-context memory of the agent. tools (List[str]): The tools used by the agent. This includes any memory editing functions specified in memory. system (str): The system prompt used by the agent. llm_config (LLMConfig): The LLM configuration used by the agent. embedding_config (EmbeddingConfig): The embedding configuration used by the agent.

name
string
required

The name of the agent.

tools
string[]
required

The tools used by the agent.

system
string
required

The system prompt used by the agent.

agent_type
enum<string>
required

The type of agent.

Available options:
memgpt_agent,
split_thread_agent,
o1_agent
llm_config
object
required

The LLM configuration used by the agent.

embedding_config
object
required

The embedding configuration used by the agent.

description
string | null

The description of the agent.

metadata_
object | null

The metadata of the agent.

user_id
string | null

The user id of the agent.

id
string

The human-friendly ID of the Agent

created_at
string

The datetime the agent was created.

message_ids
string[] | null

The ids of the messages in the agent's in-context memory.

memory
object

Represents the in-context memory of the agent. This includes both the Block objects (labelled by sections), as well as tools to edit the blocks.

Attributes: memory (Dict[str, Block]): Mapping from memory block section to memory block.

tool_rules
object[] | null

The list of tool rules.

tags
string[] | null

The tags associated with the agent.