# REQO API

> HTTP API and MCP server for a browser-based screen recorder and video editor.

## Authentication first

REQO issues **no API keys** and implements **no client-credentials flow**. An
agent acts on behalf of a signed-in human:

1. Send the user to [https://reqo.me/api/auth/signin](https://reqo.me/api/auth/signin)
2. Keep the resulting httpOnly session cookie
3. Send that cookie on every request

Verify a session with `GET /api/auth/session`; it returns the user, or `{}`
when there is none. A 401 means sign in again, not retry. A 403 means the
resource is deliberately gated.

Full detail: [auth.md](https://reqo.me/auth.md) ·
[authenticate skill](https://reqo.me/.well-known/agent-skills/authenticate/SKILL.md)

## MCP server (preferred)

Endpoint: `https://reqo.me/mcp` - Streamable HTTP, protocol `2025-06-18` or
`2025-03-26`. Stateless: no session id to carry.

- `health_check` (no auth) - Health check
- `list_videos` - List videos
- `get_video` - Get a video
- `get_captions` - Get captions or subtitles
- `list_projects` - List editing projects
- `create_project` - Create an editing project
- `transcribe_video` - Transcribe REQO-hosted media

`initialize` and `tools/list` work unauthenticated so you can discover the
surface before signing in.

- [How to connect](https://reqo.me/.well-known/agent-skills/use-mcp-server/SKILL.md)
- [Server card](https://reqo.me/.well-known/mcp/server-card.json)

## REST

The same surface, described in full:

- [OpenAPI 3.1](https://reqo.me/openapi.json)
- [API catalog (RFC 9727)](https://reqo.me/.well-known/api-catalog)

Core endpoints:

- `GET /api/health` - liveness, no auth
- `GET /api/videos` - list videos in the active workspace
- `GET /api/videos/:id` - one video
- `GET /api/videos/:id/captions` - caption status, or `?format=srt`/`vtt`
- `GET /api/projects` · `POST /api/projects` - editing projects
- `POST /api/transcribe` - Whisper large-v3 transcript from a media URL
- `POST /api/videos/multipart/init` → `/complete` (or `/abort`) - chunked upload

## Payments

Some endpoints can be paid for per call by an agent without a subscription.
See [payment discovery](https://reqo.me/.well-known/ucp) and the
`x-payment-info` extensions in the OpenAPI document.

## Conduct

Rate limits are per session. Media endpoints serve large files: fetch an asset
once and cache it rather than re-requesting per frame.

## Related

- [Full site index](https://reqo.me/llms.txt)
- [Machine-readable pricing](https://reqo.me/pricing.md)
- [Agent skills index](https://reqo.me/.well-known/agent-skills/index.json)