# Welcome to Geekbot's API

> Use the Geekbot API to manage standups, polls, reports, users, and team data from your own tools and workflows.

All requests are made over HTTPS to https://api.geekbot.com and authenticated with an API key in the `Authorization` header.

## API specification

- [OpenAPI spec (JSON)](/openapi.json): Complete machine-readable OpenAPI 3.0 document — the preferred source for tools and agents.
- [OpenAPI spec (YAML)](/openapi.yaml): The same document in YAML.
- [Full API reference (Markdown)](/llms-full.txt): Every endpoint with parameters, request/response shapes, and errors as plain Markdown.

## Current

- `GET /v1/me` — Get current user
- `GET /v1/me/teams` — List user teams
- `GET /v1/me/standups` — List user standups
- `GET /v1/teams/` — List teams
- `GET /v2/polls` — List polls
- `POST /v2/polls` — Create poll
- `GET /v2/polls/{pollId}` — Get poll
- `GET /v2/polls/{pollId}/votes` — Get poll votes
- `GET /v2/reports` — List reports
- `POST /v2/reports` — Create report
- `GET /v2/reports/{reportId}` — Get report
- `PATCH /v2/reports/{reportId}` — Update report
- `DELETE /v2/reports/{reportId}` — Delete report
- `GET /v2/standups` — List standups
- `POST /v2/standups` — Create standup
- `GET /v2/standups/{standupId}` — Get standup

## Legacy

- `GET /v1/polls` — List polls
- `POST /v1/polls` — Create poll
- `GET /v1/polls/{id}` — Get poll
- `GET /v1/polls/{id}/votes` — Get poll results
- `GET /v1/reports/` — List reports
- `POST /v1/reports/` — Create report
- `GET /v1/standups/` — List standups
- `POST /v1/standups/` — Create standup
- `GET /v1/standups/{id}` — Get standup
- `DELETE /v1/standups/{id}` — Delete standup
- `PATCH /v1/standups/{id}` — Update standup
- `PUT /v1/standups/{id}` — Replace standup
- `POST /v1/standups/{id}/duplicate` — Duplicate standup
- `POST /v1/standups/{id}/start` — Start standup

## Tools

- [Geekbot CLI & AI Skill](https://github.com/geekbot-com/geekbot-cli): Submit reports, analyse responses, and manage standups and polls from your terminal or AI coding agent.
- [Geekbot MCP Server](https://github.com/geekbot-com/geekbot-mcp): Connect AI assistants to Geekbot via the Model Context Protocol.