The new way to API.
Core Concepts
Contextual / Dynamic Intent
Last Updated: May 29, 2025AgenticAPI supports contextual and dynamic intent through methodss that adapt to the specific context or target of a task, enabling flexible, intent-driven interactions for AI agents. These verbs, often simple and versatile (e.g., CHECK, GET, SET), derive their meaning from the parameters and context provided, allowing a single method to serve multiple purposes. This document…
Chaining
Last Updated: May 29, 2025Chaining in AgenticAPI allows AI agents to orchestrate complex workflows by executing a sequence of action verbs in a single request. This capability, part of the Orchestrate category, enables tasks like fetching data, summarizing it, and notifying a user to be combined seamlessly. The /chain endpoint coordinates these actions, providing traceability, error handling, and support…
Semantic Discoverability
Last Updated: May 29, 2025AgenticAPI’s semantic discoverability enables AI agents to dynamically explore and invoke API capabilities without relying on external documentation or natural language prompts. By leveraging OpenAPI extensions, AgenticAPI makes endpoints machine-readable, allowing agents to understand verbs, categories, and constraints. This document explains how discoverability works and provides an example of a planned DISCOVER /actions endpoint. OpenAPI…
Responses
Last Updated: May 29, 2025AgenticAPI responses are designed to provide clear outcomes and support AI agent decision-making. Each response follows a standardized structure, ensuring execution clarity and adaptability across action verbs. This document details the response structure, including status, result, and next_action fields, with examples for common verbs. Response Structure Responses include the following key components: The structure is…
Payloads and Parameters
Last Updated: May 29, 2025AgenticAPI’s action-oriented design relies on well-defined input payloads to ensure AI agents can execute tasks with precision. Payloads are structured using Pydantic schemas, providing type safety and validation. This document describes the key components of payloads, intent modifiers, context references, and execution hints, and provides examples for common verbs. Payload Components Payloads consist of three…
ACTION Taxonomy
Last Updated: May 29, 2025AgenticAPI redefines API design by replacing traditional CRUD operations (Create, Read, Update, Delete) with action-oriented verbs that reflect specific tasks or intentions. These verbs, part of the ACTION framework, enable AI agents to interact with APIs in a way that aligns with real-world objectives, such as fetching data, summarizing content, or sending notifications. This document…