> ## Documentation Index > Fetch the complete documentation index at: https://flowdrop.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List available tools on the runtime > Retrieve a list of tools registered on the Agent Spec runtime. These tools can be referenced by `tool_node` components. ## OpenAPI ````yaml /api-reference/openapi.yaml get /agentspec/tools openapi: 3.0.3 info: title: FlowDrop™ API description: > FlowDrop is a visual workflow editor for AI applications and data processing pipelines. This API provides comprehensive endpoints for managing workflows, node types, pipeline execution, and port configuration. ## Features - **Workflow Management**: Complete CRUD operations for workflows with nodes and edges - **Node Type Discovery**: Browse and search available node processors with metadata - **Pipeline Execution**: Execute workflows with real-time status tracking and job management - **Port Configuration**: Dynamic port compatibility system with data type management - **Real-time Updates**: Track node execution status and pipeline progress - **Import/Export**: Import and export workflows in JSON format - **Validation**: Workflow validation before execution - **Agent Spec Integration**: Import/export Oracle Open Agent Spec flows and execute on compatible runtimes (WayFlow/PyAgentSpec) ## Architecture - **Frontend**: Svelte 5 + XYFlow for visual workflow editing - **Backend**: Drupal 10/11 with custom node processor plugins - **API**: RESTful JSON API with consistent response format - **Storage**: Drupal entity system with workflow versioning ## Authentication API endpoints require Drupal authentication. Use Bearer token or session-based authentication. ## Rate Limiting - Node Discovery: 100 requests/minute - Workflow Operations: 50 requests/minute - Pipeline Execution: 20 requests/minute ## Error Handling All errors return a consistent format with success flag, error message, and optional details. version: 1.0.0 contact: name: FlowDrop Support email: shibinkidd@gmail.com url: https://www.drupal.org/project/issues/flowdrop?categories=All servers: - url: http://localhost:5173/api/flowdrop description: Local development server (Svelte) - url: https://flowdrop.ddev.site/api/flowdrop description: Local Drupal server security: - BearerAuth: [] - SessionAuth: [] tags: - name: System description: System health and status endpoints - name: Node Types description: Node type discovery and metadata endpoints - name: Configuration description: System configuration endpoints including port configuration - name: Workflows description: Workflow CRUD operations - name: Pipeline description: Pipeline execution and monitoring - name: Playground description: Interactive workflow testing and chat interface - name: Interrupts description: | Human-in-the-Loop (HITL) interrupt endpoints for workflow interactions. Interrupts allow workflows to pause execution and request user input. - name: Validation description: Workflow validation - name: Import/Export description: Workflow import and export operations - name: Chat description: | LLM Chat Interface for natural language workflow building. Translates user intent into DSL commands via a backend LLM integration. - name: Agent Spec description: > Oracle Open Agent Spec integration endpoints. Provides bidirectional conversion between FlowDrop workflows and Agent Spec format, plus runtime execution on compatible runtimes (WayFlow, PyAgentSpec). @see https://github.com/oracle/agent-spec paths: /agentspec/tools: get: tags: - Agent Spec summary: List available tools on the runtime description: | Retrieve a list of tools registered on the Agent Spec runtime. These tools can be referenced by `tool_node` components. operationId: agentSpecListTools responses: '200': description: List of available tools content: application/json: schema: type: array items: $ref: '#/components/schemas/AgentSpecRuntimeTool' '401': $ref: '#/components/responses/Unauthorized' '500': $ref: '#/components/responses/InternalServerError' components: schemas: AgentSpecRuntimeTool: type: object description: Tool available on the runtime properties: name: type: string description: Tool name description: type: string description: Tool description component_type: $ref: '#/components/schemas/AgentSpecToolComponentType' inputs: type: array items: $ref: '#/components/schemas/AgentSpecProperty' outputs: type: array items: $ref: '#/components/schemas/AgentSpecProperty' AgentSpecToolComponentType: type: string enum: - server_tool - client_tool - remote_tool description: | Agent Spec tool component_type discriminator. - `server_tool` — Executed in the same runtime environment - `client_tool` — Executed by the client, results returned to runtime - `remote_tool` — Triggered via RPC/REST calls AgentSpecProperty: type: object description: > JSON Schema-based input/output property definition. Uses JSON Schema types and structure for describing data shape. Placeholder syntax `{{variable_name}}` generates implicit input properties. properties: title: type: string description: Property name (used as identifier in edges and templates) example: user_query type: type: string description: JSON Schema type example: string enum: - string - number - integer - boolean - array - object description: type: string description: Human-readable description default: description: Default value enum: type: array items: {} description: Allowed values (JSON Schema enum) items: $ref: '#/components/schemas/AgentSpecProperty' description: Array item schema (for type=array) properties: type: object additionalProperties: $ref: '#/components/schemas/AgentSpecProperty' description: Object property schemas (for type=object) required: type: array items: type: string description: Required properties (for type=object) required: - title - type ErrorResponse: allOf: - $ref: '#/components/schemas/ApiResponse' - type: object properties: success: type: boolean example: false error: type: string description: Error message code: type: string description: Error code details: type: object description: Additional error details ApiResponse: type: object properties: success: type: boolean description: Whether the request was successful data: description: Response data (type varies by endpoint) message: type: string description: Response message error: type: string description: Error message (if any) responses: Unauthorized: description: Unauthorized - authentication required content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false error: Authentication required code: UNAUTHORIZED InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: success: false error: Internal server error code: INTERNAL_ERROR securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: JWT token for authentication SessionAuth: type: apiKey in: cookie name: SESS description: Drupal session cookie ````