---
title: "Introduction"
description: "Every Rumoro endpoint, generated from the OpenAPI document the API serves."
canonical: https://docs.rumoro.dev/api
markdown: https://docs.rumoro.dev/api.mdx
---

# Introduction

Every Rumoro endpoint, generated from the OpenAPI document the API serves.

Send every request to this base URL.

```
https://api.rumoro.dev/v1
```

Authenticate with a Bearer API key from the dashboard, or an OAuth token from an [MCP sign-in](/mcp).

```ts tab="TypeScript"
import { createRumoro } from '@rumoro-dev/sdk';

const rumoro = createRumoro({ apiKey: 'ref_...' });
await rumoro.listKeywords();
```

```python tab="Python"
from rumoro import Rumoro

rumoro = Rumoro(api_key="ref_...")
rumoro.keywords.list()
```

```bash tab="curl"
curl https://api.rumoro.dev/v1/keywords \
  -H "Authorization: Bearer ref_..."
```

These pages are built from the API's own [OpenAPI document](https://api.rumoro.dev/v1/openapi.json), which also validates requests. Each page's playground sends real requests to your workspace, so explore with a `read` key.

Start with [Keywords](/api/keywords/create-keyword) and [Mentions](/api/mentions/search-mentions), or read [Conventions](/conventions). Slack, Telegram and delivery-log retries have their own pages.