> For the complete documentation index, see [llms.txt](https://angoor-ai.gitbook.io/angoor-ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://angoor-ai.gitbook.io/angoor-ai/basics/configuration/tools/api-tools.md).

# API Tools

External integration utilities that connect third-party services and APIs to your angoor.ai workflows, enabling data exchange and action automation.

## Creating API Tools

**Step 1:** Click "New" and select "API Tool" to start configuration.

**Step 2:** Import or define your API schema using URL, file upload, or manual entry.

**Step 3:** Configure authentication method and credentials.

**Step 4:** Map API endpoints to tool functions.

**Step 5:** Test connections and save configuration.

## **API Tool Configuration**

### **Core Tab**

<figure><img src="/files/PaU3WM7xrL2HCTZHsczp" alt=""><figcaption></figcaption></figure>

#### Configuration Process

Import your API schema via URL, file upload, or manual entry to automatically generate tool configurations from OpenAPI/Swagger specifications, saving time and ensuring accuracy in endpoint definitions.

#### Schema Definition

Define available endpoints, HTTP methods, parameters, and response formats to create a complete blueprint of how your tool will interact with the external API and handle data exchange.

#### API Details

Configure base URL, version information, and documentation links to maintain proper API connections and provide reference materials for team members using the tool.

#### Authorization Configuration&#x20;

Set up secure authentication using Basic, Bearer, or Custom methods to ensure your API connections are protected while maintaining ease of use for authorized workflows.

#### Authorization Fields

Specify header names, credential values, and optional flags to handle various API authentication requirements and ensure flexible integration with different service providers.

### Settings Tab&#x20;

Set descriptive names, detailed documentation, and organizational tags to ensure your API tools are easily discoverable and understandable by team members.

<figure><img src="/files/Zfsctw8hpikuC1EV8Jaf" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://angoor-ai.gitbook.io/angoor-ai/basics/configuration/tools/api-tools.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.