How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Profound Documents API

The Documents API from Profound — 3 operation(s) for documents.

Profound Documents API is one of 16 APIs that Profound publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Documents. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and a changelog.

This API exposes 6 operations across 3 paths, and defines 13 schemas. It is described by OpenAPI 3.2.0, at version 6551bd49db665ffb7f80780b3e150b8e8b780cc3.

Requests are made against a single base URL, https://api.tryprofound.com.

6 operations 3 paths 13 schemas 1 DELETE2 GET1 PATCH2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
6551bd49db665ffb7f80780b3e150b8e8b780cc3
Base URL
https://api.tryprofound.com
Authentication
API Key, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Profound Documents API declares 2 security schemes for authenticating requests. An API key is passed in the header as X-API-Key (APIKeyHeader). It accepts HTTP bearer tokens (BearerAuth).

Paths & Operations 6

Across 3 paths, the API surfaces 6 operations — 1 DELETE, 2 GET, 1 PATCH, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Documents 6
GET
/v1/documents
List documents
list_documents_v1_documents_get 5 params → 200422
POST
/v1/documents
Create a document
create_document_v1_documents_post body → 201422
GET
/v1/documents/{document_id}
Read a document
read_document_v1_documents__document_id__get 5 params → 200422
PATCH
/v1/documents/{document_id}
Rename or reshare a document
patch_document_v1_documents__document_id__patch 1 param body → 200422
DELETE
/v1/documents/{document_id}
Delete a document
delete_document_v1_documents__document_id__delete 2 params → 204422
POST
/v1/documents/{document_id}/content
Replace a document's content
replace_document_content_v1_documents__document_id__content_post 1 param body → 200422

Schemas 13

The contract defines 13 schemas that model the data the API accepts and returns. The most detailed are ReadDocumentResponse (17 properties), ReplaceDocumentContentResponse (14 properties), CreateDocumentResponse (13 properties), Document (12 properties). Each schema is shown below with its type and property counts.

HTTPValidationError
object
1 property
UpdateDocumentRequest
object
Request body for renaming or resharing a document.
3 properties 1 required
ReadDocumentResponse
object
A document's metadata, its default tab's body, its other tabs, its comments, and the change-detection token for it.
17 properties 13 required
CreateDocumentRequest
object
Request body for creating a document with markdown content.
4 properties 4 required
ListDocumentsResponse
object
A page of documents.
2 properties 2 required
ValidationError
object
5 properties 3 required
CreateDocumentResponse
object
The document that was created, plus the change-detection token minted for this write.
13 properties 13 required
ReplaceDocumentContentResponse
object
The document after its content was replaced, plus the change-detection token and how much landed.
14 properties 14 required
AdditionalTab
object
One of a document's tabs beyond the default one.
2 properties 2 required
ReplaceDocumentContentRequest
object
Request body for replacing a document's entire content.
3 properties 2 required
Comment
object
One review comment, mapped from upstream's open, unvalidated shape into a closed contract. Upstream's own comment schema — body, quotedtext, author, replies, r…
2 properties 1 required
CursorPagination
object
Cursor-based pagination metadata.
2 properties
Document
object
A Profound document.
12 properties 12 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

profound-documents-api-openapi.yml Raw ↑

Other APIs Profound publishes across the network.

Profound Agent Analytics Ingestion API
Profound Agents API
Profound Beta API
Profound Bot Traffic Reports API
Profound Categories API
Profound Content API
Profound Content optimization API
Profound Human Referrals API
Profound Integrations API
Profound Knowledge bases API
Profound OpenAI Ads API
Profound Organization API
Where this information came from

This is an independent, third-party profile of Profound Documents API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.