# Divinci AI API API

**Canonical:** https://apis.io/apis/divinci-app/divinci-ai-api-api/  
**Provider:** Divinci — https://apis.io/providers/divinci-app/  
**Base URL:** https://api.divinci.ai/api/v1  
**Documentation:** https://divinci.ai/openapi.yaml

Divinci AI API API is one of 2 APIs that [Divinci](https://apis.io/providers/divinci-app/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

RESTful API for managing AI releases, RAG knowledge bases, fine-tuning, transcripts, and more. Authenticate with an API key via the `X-Api-Key` header or a Bearer token.

## Operations (60)

| Method | Path | Summary |
|---|---|---|
| GET | `/` | API info and endpoint listing |
| POST | `/auth/validate-key` | Validate API key |
| GET | `/transcripts` | List transcripts |
| POST | `/transcripts` | Create transcript |
| GET | `/transcripts/{transcriptId}` | Get transcript |
| DELETE | `/transcripts/{transcriptId}` | Delete transcript |
| POST | `/transcripts/{transcriptId}/messages` | Add message to transcript |
| GET | `/rag/files` | List RAG files |
| POST | `/rag/files` | Upload file for RAG indexing |
| POST | `/rag/presigned` | Get presigned R2 upload URLs |
| POST | `/rag/files/audio` | Upload audio from URL |
| POST | `/rag/files/audio-from-presigned` | Finalize presigned audio upload |
| GET | `/rag/files/{fileId}` | Get RAG file |
| DELETE | `/rag/files/{fileId}` | Delete RAG file |
| POST | `/rag/files/{fileId}/reindex` | Re-index RAG file |
| GET | `/rag/targets` | List RAG vector indexes |
| GET | `/rag/search` | Search knowledge base |
| GET | `/releases` | List releases |
| POST | `/releases` | Create release draft |
| GET | `/releases/{releaseId}` | Get release |
| PATCH | `/releases/{releaseId}` | Update release draft |
| DELETE | `/releases/{releaseId}` | Delete release draft |
| POST | `/releases/{releaseId}/publish` | Publish release |
| GET | `/fine-tune/jobs` | List custom AI models |
| POST | `/fine-tune/jobs` | Create custom AI model |
| GET | `/fine-tune/jobs/{customAiId}` | Get custom AI model |
| DELETE | `/fine-tune/jobs/{customAiId}` | Delete custom AI model |
| POST | `/fine-tune/jobs/{customAiId}/start` | Start fine-tuning |
| GET | `/fine-tune/jobs/{customAiId}/status` | Get fine-tune status |
| POST | `/fine-tune/jobs/{customAiId}/cancel` | Cancel fine-tuning |
| GET | `/config` | Get whitelabel configuration |
| PATCH | `/config/title` | Update title |
| PATCH | `/config/description` | Update description |
| GET | `/audio-transcripts` | List audio transcripts |
| POST | `/audio-transcripts/url` | Upload audio from URL |
| GET | `/audio-transcripts/{audioId}` | Get audio transcript |
| DELETE | `/audio-transcripts/{audioId}` | Delete audio transcript |
| POST | `/audio-transcripts/{audioId}/generate-rag` | Generate RAG from audio transcript |
| GET | `/connectors` | List all connections |
| GET | `/connectors/{provider}` | Get connection status |
| POST | `/connectors/{provider}/auth` | Initiate OAuth or validate credentials |
| POST | `/connectors/{provider}/disconnect` | Revoke connection |
| GET | `/html-pages` | List crawled HTML pages |
| GET | `/html-pages/count` | Get total page count |
| GET | `/html-pages/by-url` | Get page by URL |
| GET | `/html-pages/hosts` | List unique hosts |
| GET | `/html-pages/hosts/history` | List crawl history |
| GET | `/html-pages/hosts/{urlHost}/history` | Crawl history for host |
| GET | `/html-pages/{pageId}` | Get specific page |
| GET | `/notifications` | List notifications |
| GET | `/notifications/counts` | Get notification counts |
| PATCH | `/notifications/{notificationId}/read` | Mark notification read or unread |
| GET | `/threads` | List threads |
| GET | `/threads/{chatId}` | Get thread |
| GET | `/voiceprints` | List voiceprints |
| GET | `/export` | Export configuration |
| POST | `/export` | Import configuration |
| POST | `/tts/generate` | Generate TTS audio |
| GET | `/tts/settings` | Get TTS settings |
| PATCH | `/tts/settings` | Update TTS settings |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/divinci-app/openapi/_original/divinci-app-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/divinci-app/json-schema/divinci-app-audio-transcript-schema.json
- **JSONSchema** — https://artifacts.apis.io/divinci-app/json-schema/divinci-app-fine-tune-job-schema.json
- **JSONSchema** — https://artifacts.apis.io/divinci-app/json-schema/divinci-app-release-schema.json
- **JSONSchema** — https://artifacts.apis.io/divinci-app/json-schema/divinci-app-rag-file-schema.json
- **JSONSchema** — https://artifacts.apis.io/divinci-app/json-schema/divinci-app-thread-schema.json
- **JSONSchema** — https://artifacts.apis.io/divinci-app/json-schema/divinci-app-html-page-schema.json

## Other Divinci APIs (1)

- [Divinci AI API](https://apis.io/apis/divinci-app/divinci-ai-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/divinci-app/divinci-ai-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/divinci-app/.