> ## Documentation Index
> Fetch the complete documentation index at: https://docs.danubeai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Reference

> Danube REST API for tool discovery, execution, workflows, and more

# Danube API

The Danube API provides programmatic access to tool discovery, execution, workflows, agent-friendly sites, and more. Use these endpoints to integrate Danube capabilities into your own applications.

<Info>
  **Base URL:** `https://api.danubeai.com/v1`
</Info>

## Authentication

Include your API key in the request headers:

```bash theme={null}
curl -X GET "https://api.danubeai.com/v1/tools/search?query=weather" \
  -H "danube-api-key: YOUR_API_KEY"
```

Some endpoints are fully public and require no authentication. Each endpoint page notes which auth is required.

## Rate Limits

API requests are rate limited based on your plan:

| Plan       | Requests/minute |
| ---------- | --------------- |
| Free       | 60              |
| Pro        | 300             |
| Enterprise | Custom          |

## Endpoints Overview

### Tools (API Key)

<CardGroup cols={2}>
  <Card title="List Tools" icon="list" href="/api-reference/endpoint/list_tools">
    Get all available tools
  </Card>

  <Card title="Search Tools" icon="magnifying-glass" href="/api-reference/endpoint/search_tools">
    Find tools using natural language
  </Card>

  <Card title="Get Tool" icon="wrench" href="/api-reference/endpoint/get_tool">
    Get tool details by ID
  </Card>

  <Card title="Get Tool by Name" icon="tag" href="/api-reference/endpoint/get_tool_by_name">
    Look up a tool by exact name
  </Card>

  <Card title="Call Tool" icon="play" href="/api-reference/endpoint/call_tools">
    Execute a tool with parameters
  </Card>
</CardGroup>

### Services (Public)

<CardGroup cols={2}>
  <Card title="List Services" icon="server" href="/api-reference/endpoint/list_services">
    Browse available service providers
  </Card>

  <Card title="Get Service" icon="circle-info" href="/api-reference/endpoint/get_service">
    Get service details
  </Card>

  <Card title="Get Service Tools" icon="toolbox" href="/api-reference/endpoint/get_service_tools">
    Get all tools for a service
  </Card>
</CardGroup>

### Skills (Public)

<CardGroup cols={2}>
  <Card title="List Skills" icon="book" href="/api-reference/endpoint/list_skills">
    Browse the skills marketplace
  </Card>

  <Card title="Search Skills" icon="magnifying-glass" href="/api-reference/endpoint/search_skills">
    Find skills using natural language
  </Card>

  <Card title="Get Skill" icon="file-lines" href="/api-reference/endpoint/get_skill">
    Get skill content and scripts
  </Card>
</CardGroup>

### Workflows (Public + API Key)

<CardGroup cols={2}>
  <Card title="List Public Workflows" icon="list" href="/api-reference/endpoint/list_public_workflows">
    Browse public multi-tool workflows
  </Card>

  <Card title="Get Workflow" icon="diagram-project" href="/api-reference/endpoint/get_workflow">
    Get workflow details and steps
  </Card>

  <Card title="Execute Workflow" icon="play" href="/api-reference/endpoint/execute_workflow">
    Run a workflow with inputs
  </Card>

  <Card title="Get Execution" icon="clock-rotate-left" href="/api-reference/endpoint/get_workflow_execution">
    Check workflow execution results
  </Card>
</CardGroup>

### Agent Sites (Public)

<CardGroup cols={2}>
  <Card title="List Sites" icon="globe" href="/api-reference/endpoint/list_sites">
    Browse the site directory
  </Card>

  <Card title="Search Sites" icon="magnifying-glass" href="/api-reference/endpoint/search_sites">
    Semantic search for sites
  </Card>

  <Card title="Get Site by Domain" icon="at" href="/api-reference/endpoint/get_site_by_domain">
    Look up a site by domain
  </Card>

  <Card title="Get Site" icon="circle-info" href="/api-reference/endpoint/get_site">
    Get site details by ID
  </Card>
</CardGroup>

### Ratings (Public)

<CardGroup cols={2}>
  <Card title="Get Tool Ratings" icon="star" href="/api-reference/endpoint/get_tool_ratings">
    Get aggregated ratings for a tool
  </Card>
</CardGroup>

### Credentials (API Key)

<CardGroup cols={2}>
  <Card title="Store Credential" icon="key" href="/api-reference/endpoint/store_credential">
    Store an API key or bearer token
  </Card>
</CardGroup>

### Identity (API Key)

<CardGroup cols={2}>
  <Card title="Get Identity" icon="robot" href="/api-reference/endpoint/get_identity_api">
    Get your identity for agent use
  </Card>
</CardGroup>

### Webhooks (JWT)

<CardGroup cols={2}>
  <Card title="List Webhooks" icon="list" href="/api-reference/endpoint/list_webhooks">
    Get all your webhooks
  </Card>

  <Card title="Create Webhook" icon="plus" href="/api-reference/endpoint/create_webhook">
    Register a new webhook endpoint
  </Card>

  <Card title="Update Webhook" icon="pen" href="/api-reference/endpoint/update_webhook">
    Change URL, events, or active status
  </Card>

  <Card title="Get Deliveries" icon="clock-rotate-left" href="/api-reference/endpoint/get_webhook_deliveries">
    View delivery history
  </Card>
</CardGroup>

### Device Auth (Public)

<CardGroup cols={2}>
  <Card title="Create Device Code" icon="mobile" href="/api-reference/endpoint/create_device_code">
    Start device auth flow
  </Card>

  <Card title="Poll Device Token" icon="arrows-rotate" href="/api-reference/endpoint/poll_device_token">
    Poll for API key
  </Card>
</CardGroup>

## Response Format

All API responses are JSON. Error responses include details:

```json theme={null}
{
  "detail": "Error message describing what went wrong"
}
```

Common HTTP status codes:

| Code | Meaning                                |
| ---- | -------------------------------------- |
| 200  | Success                                |
| 400  | Bad request (invalid parameters)       |
| 401  | Unauthorized (missing or invalid auth) |
| 403  | Forbidden (insufficient permissions)   |
| 404  | Not found                              |
| 429  | Rate limited                           |

## SDKs and Libraries

* **Python SDK:** `pip install danube` — see [Python SDK docs](/sdk/python)
* **MCP Protocol:** Connect AI assistants directly — see [Quickstart](/quickstart)
* **REST API:** Use the endpoints documented here with any HTTP client