# Docora API

Version: `1.0.0`

Visitors talk to the public endpoints (`/v1/chat`, `/v1/widget/config`). Everything under `/v1/projects` manages your account and needs an access token.

## Servers

- `http://localhost:8787`

## Endpoints

### Chat

Ask questions about your documentation.

- [`POST /v1/chat`](/api/ask#chat): Ask a question

### Widget

What the embedded widget reads on load.

- [`GET /v1/widget/config`](/api/widget#widgetconfig): Get the widget configuration

### Projects

Create and configure assistants.

- [`GET /v1/projects`](/api/projects#listprojects): List projects
- [`POST /v1/projects`](/api/projects#createproject): Create a project
- [`GET /v1/projects/{id}`](/api/projects#getproject): Get a project
- [`PATCH /v1/projects/{id}`](/api/projects#updateproject): Update a project
- [`DELETE /v1/projects/{id}`](/api/projects#deleteproject): Delete a project

### Sources

Connect and sync public documentation.

- [`GET /v1/projects/{id}/sources`](/api/sources#listsources): List sources
- [`POST /v1/projects/{id}/sources`](/api/sources#createsource): Add a documentation source
- [`PATCH /v1/projects/{id}/sources/{sourceId}`](/api/sources#updatesource): Update a source
- [`DELETE /v1/projects/{id}/sources/{sourceId}`](/api/sources#deletesource): Delete a source
- [`POST /v1/projects/{id}/sources/{sourceId}/sync`](/api/sources#syncsource): Re-sync a source