timeless

# Timeless

> **Source**: [github.com/supertools/timeless-skills](https://github.com/supertools/timeless-skills)

Interact with [Timeless](https://timeless.day) meeting data: search meetings, read transcripts, get AI summaries, browse rooms, upload recordings, chat with the AI agent, and capture podcasts/YouTube videos for transcription.

## API Reference

For full endpoint documentation with response schemas, status enums, and detailed examples, read `api-reference.md` (in this skill folder).

## Prerequisites

- `TIMELESS_ACCESS_TOKEN` env var (get token at [my.timeless.day/api-token](https://my.timeless.day/api-token))
- `yt-dlp` for YouTube downloads (install via package manager: `apt install yt-dlp`, `brew install yt-dlp`, or `pip install yt-dlp`. Alternatively set `YTDLP_PATH` to point to an existing binary.)

Set up in OpenClaw:
```bash
openclaw config patch env.vars.TIMELESS_ACCESS_TOKEN=<your_token>
```

## Base URL

```
https://my.timeless.day
```

## Authentication Header

All requests:
```
Authorization: Token $TIMELESS_ACCESS_TOKEN
```

---

## Operations

### 1. List Meetings

```
GET /api/v1/spaces/meeting/
```

**Required parameter:** `include` must be `owned` or `shared`.

| Parameter | Type | Description |
|-----------|------|-------------|
| `include` | string | **Required.** `owned` or `shared` |
| `search` | string | Search by title or attendees |
| `start_date` | string | From date (YYYY-MM-DD) |
| `end_date` | string | To date (YYYY-MM-DD) |
| `status` | string | `COMPLETED`, `SCHEDULED`, `PROCESSING`, `FAILED` |
| `page` | integer | Page number (default: 1) |
| `per_page` | integer | Results per page (default: 20) |

```bash
curl -s "https://my.timeless.day/api/v1/spaces/meeting/?include=owned&status=COMPLETED&per_page=50" \
  -H "Authorization: Token $TIMELESS_ACCESS_TOKEN"
```

**Response:** `{ count, next, previous, results: [{ uuid, title, start_ts, end_ts, status, primary_conversation_uuid, host_user, conversation_source, created_at }] }...