RUrunbear

Get agent session-start hook

Retrieve the agent's session-start hook — the Custom MCP tool the engine invokes server-side once at the start of a thread to inject deterministic per-user context. Returns 404 when the agent is not found, its provider does not support tool integrations, or no hook is configured.

get/v1/agents/{id}/session-start-hook

Request

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

Path parameters

idstring uuid required

Agent ID

Response

Default Response

appstring required

Custom MCP integration namespace (app) that hosts the hook tool.

toolNamestring required

Name of the MCP tool invoked server-side once at session start. Hidden from the model's tool list.

timeoutMsinteger

Per-call timeout in milliseconds. On timeout the engine degrades gracefully (responds without injected context). Omit for the engine default.

staticArgsobject

Constant arguments always passed to the hook tool, applied only when the tool's input schema declares a matching property (e.g. an authorization key: { "invocation_key": "…" }). NON-SECRET values only — secrets belong in the integration's httpHeaders.

Changes

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