Create agent

Create a new agent with the specified configuration. Only Anthropic, OpenAI Responses, Gemini, and Claude Agent SDK providers are supported.

post/v1/agents

Request

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

Request body

namestring required

Name of the agent

systemPromptstring

The system prompt for this agent. Limited to 200000 characters; put reference material in a knowledge base rather than in the prompt.

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.