Profound

Profound Documents API

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

GitHub OpenAPI

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v1/documents List the organization's documents · List documents #
Ask an LLM
“Which Profound documents can my organization see, most recently edited first?”
“Can I search my documents by text?”
Tell an agent
List documents in organization {organization_id}.
Find documents matching {q} in organization {organization_id}.
POST /v1/documents Create a markdown document · Create a document #
Ask an LLM
“How do I create a new document from markdown?”
“What happens if I send a create request with a document id that already exists?”
Tell an agent
Create document {id} named {name} in org {organization_id} with this markdown: {content_markdown}
Make a new doc titled {name} for organization {organization_id} using id {id} and body {content_markdown}.
GET /v1/documents/{document_id} Read a document with tabs and comments · Read a document #
Ask an LLM
“Can I read the full text and comments of a document?”
“Why is the document body truncated, and how do I get the version hash?”
Tell an agent
Read document {document_id} in org {organization_id}.
Open document {document_id} for org {organization_id} without preview, including comments {include_comments}.
PATCH /v1/documents/{document_id} Rename a document or change its visibility · Rename or reshare a document #
Ask an LLM
“How do I rename a document?”
“Can I change who is able to see a document, and who is allowed to do that?”
Tell an agent
Rename document {document_id} in org {organization_id} to {name}.
Set visibility of document {document_id} in org {organization_id} to {visibility}.
DELETE /v1/documents/{document_id} Delete a document created via the API · Delete a document #
Ask an LLM
“Can I delete a document that was created through the API?”
“Is a deleted document recoverable, and can I delete ones made in the app?”
Tell an agent destructive · confirm first
Delete document {document_id} from organization {organization_id}.
Remove the API-created document {document_id} in org {organization_id} permanently.
POST /v1/documents/{document_id}/content Overwrite a document's entire body · Replace a document's content #
Ask an LLM
“How do I replace all the text in a document with new markdown?”
“Will overwriting a document's content wipe its other tabs and comment threads?”
Tell an agent destructive · confirm first
Overwrite the body of document {document_id} in org {organization_id} with {content_markdown}.
Replace document {document_id}'s content in org {organization_id} with {content_markdown} and keep the title (skip_title_sync {skip_title_sync}).

Documentation

📖
Documentation
https://docs.tryprofound.com/rest-api/introduction
📖
APIReference
https://docs.tryprofound.com/api-reference/organization/get-categories
📖
Authentication
https://docs.tryprofound.com/rest-api/authentication

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/profound/refs/heads/main/openapi/profound-documents-api-openapi.yml

Other Resources

🔗
OpenAPI Source
https://api.tryprofound.com/openapi.json
🔗
ChangeLog
https://docs.tryprofound.com/rest-api/changelog

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/profound:profound-documents-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

profound-documents-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: External Documents API
  version: 6551bd49db665ffb7f80780b3e150b8e8b780cc3
servers:
- url: https://api.tryprofound.com
  description: Production Server
tags:


# --- truncated at 32 KB (42 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/profound/refs/heads/main/openapi/profound-documents-api-openapi.yml