RUrunbear

Update agent

Update an existing agent's configuration. Only provided fields will be updated (partial update). Provider type cannot be changed.

patch/v1/agents/{id}

Request

  • Base URL
    https://api.runbear.io
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

The ID of the agent to retrieve

Example:0fade940-133f-49e6-bf4b-8f662186479b

Request body

namestring

Name of the agent

systemPromptstring

The system prompt for this agent. Pass an empty string to clear the current prompt. Limited to 200000 characters, except on agents whose stored prompt is already longer — those accept any prompt no longer than the one they currently have.

timeoutMinutesinteger

Maximum execution time in minutes for a single chat completion. Defaults to 6 minutes if omitted; capped at 20 minutes.

Response

Default Response

idstring uuid required

Unique identifier for the agent

namestring required

Name of the agent

systemPromptstring nullable required

The system prompt stored for this agent on Runbear. This is the configured prompt, not the fully composed one: agents that support context blocks append them to it at invocation time.

timeoutMinutesinteger required

Maximum execution time in minutes for a single chat completion. Defaults to 6 minutes; capped at 20 minutes.

createdAtstring required

ISO 8601 timestamp when the agent was created

lastModifiedAtstring required

ISO 8601 timestamp of the last update to the agent record. May reflect system-driven updates, not only user edits.

channelsstring[] required

Connected communication channels (slack, teams, discord, hubspot, zendesk)

Changes

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