Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.snorbe.deskrex.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
List Tools

Returns the catalog of tools the agent can invoke internally during POST /agent/run / POST /agent/run/stream execution. Use this to surface agent capabilities in your UI or to validate tool availability ahead of time.
No authentication required (public). The endpoint returns a static catalog that does not depend on the workspace.

​
Request

GET /api/v1/agent/tools
No headers or query parameters required.

​
Response

{
  "tools": [
    {
      "id": "search",
      "displayName": "Web Search",
      "category": "research",
      "description": "General web search with query generation, SERP selection, scraping, and summary."
    },
    {
      "id": "x_search",
      "displayName": "X Search",
      "category": "research",
      "description": "Search posts on X (Twitter) with optional date range and account filters."
    },
    {
      "id": "plan",
      "displayName": "Plan",
      "category": "generation",
      "description": "Draft a multi-step research plan for human review before executing the full workflow."
    },
    {
      "id": "confirm_plan",
      "displayName": "Confirm Plan",
      "category": "hitl",
      "description": "Confirm a plan draft and start execution."
    },
    {
      "id": "mention_agent",
      "displayName": "Mention Agent",
      "category": "agent_integration",
      "description": "Hand off work to another agent referenced in the input via agent:// mention."
    }
  ]
}

​
Response fields

FieldTypeDescription
tools[].idstringInternal tool identifier used by the agent
tools[].displayNamestringHuman-readable label for UI display
tools[].categorystringCategory bucket. See below
tools[].descriptionstringShort description of the tool’s behavior
tools[].trigger?stringTrigger conditions in the chat-routing prompt (when applicable)
tools[].inputs?stringPrimary input parameters (when applicable)
tools[].modes?string[]Supported modes (e.g. matrix’s create / edit / continue)
tools[].flow?string[]Ordered internal workflow steps
tools[].sseEvents?string[]Related SSE event names emitted by this tool
tools[].notes?stringAdditional notes (external endpoints, post-completion hooks, etc.)
trigger / inputs / modes / flow / sseEvents / notes are optional — only tools that carry them will include them.

​
Categories

ValueMeaning
researchInformation gathering — web search, X search, browser automation, source summary, RAG recall
generationStructured content generation — plans, reports, matrices
hitlDraft confirmation / regeneration / abort tools invoked by the LLM during human-in-the-loop flows
agent_integrationDelegation to other agents (mention_agent), skill execution, agent memory refresh
internalSub-tools not routed directly from chat-routing (e.g., SERP selection, in-browser helpers)
This endpoint is the source of truth for the agent’s tool set. Prefer the API response over any documentation that lists tools by name.

​
Examples

curl "https://app.snorbe.deskrex.ai/api/v1/agent/tools"

​
Error responses

HTTP statusCodeDescription
429TOO_MANY_REQUESTSRate limit exceeded (rare)