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

Taskfolk Docs API

The Docs API from Taskfolk — 9 operation(s) for docs.

Taskfolk Docs API is one of 32 APIs that Taskfolk publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Docs. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, authentication docs, and rate-limit docs.

This API exposes 14 operations across 9 paths, and defines 9 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://taskfolk.ai/api.

14 operations 9 paths 9 schemas 2 DELETE6 GET2 PATCH4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://taskfolk.ai/api
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Taskfolk Docs API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (API key) (bearerAuth). By default, every request must be authenticated.

  • bearerAuth — Workspace API key. Send as Authorization: Bearer tfklive…. Each key is bound to exactly one workspace and carries a set of scopes.

Paths & Operations 14

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

Docs 14
GET
/v1/workspaces/{slug}/docs
List docs (workspace or project-scoped).
4 params → 200400401403404429
POST
/v1/workspaces/{slug}/docs
Create a doc.
1 param body → 201400401403404429
POST
/v1/workspaces/{slug}/docs/bulk
Bulk-create docs (1–50). Returns a per-item result array; 201 when all succeed, 207 when some fail.
1 param body → 201400401403404429
GET
/v1/workspaces/{slug}/docs/{id}
Doc detail.
2 params → 200400401403404429
PATCH
/v1/workspaces/{slug}/docs/{id}
Update a doc.
2 params body → 200400401403404429
DELETE
/v1/workspaces/{slug}/docs/{id}
Archive a doc (soft).
2 params → 200400401403404429
GET
/v1/workspaces/{slug}/docs/{id}/export
Export a doc as md / html / pdf.
3 params → 200400401403404429
GET
/v1/workspaces/{slug}/docs/{id}/comments
List doc comments (oldest first).
4 params → 200400401403404429
POST
/v1/workspaces/{slug}/docs/{id}/comments
Add a doc comment (optionally threaded).
2 params body → 201400401403404429
PATCH
/v1/workspaces/{slug}/docs/{id}/comments/{commentId}
Edit a doc comment (author; owner/admin may edit any).
3 params body → 200400401403404429
DELETE
/v1/workspaces/{slug}/docs/{id}/comments/{commentId}
Delete a doc comment.
3 params → 200400401403404429
GET
/v1/workspaces/{slug}/docs/{id}/versions
List doc version snapshots (newest first; no bodies).
4 params → 200400401403404429
GET
/v1/workspaces/{slug}/docs/{id}/versions/{versionId}
Get a full version snapshot.
3 params → 200400401403404429
POST
/v1/workspaces/{slug}/docs/{id}/versions/{versionId}/restore
Restore the doc to this snapshot.
3 params → 200400401403404429

Schemas 9

The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are Doc (9 properties), DocComment (8 properties), DocVersion (7 properties), DocCreateInput (6 properties). Each schema is shown below with its type and property counts.

Pagination
object
1 property 1 required
DocVersion
object
7 properties 6 required
Doc
object
9 properties 8 required
DocComment
object
8 properties 8 required
BulkDocsCreateInput
object
1 property 1 required
ErrorEnvelope
object
1 property 1 required
BulkDocResult
DocVersionSummary
object
6 properties 6 required
DocCreateInput
object
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

taskfolk-docs-api-openapi.yml Raw ↑

Other APIs Taskfolk publishes across the network.

Taskfolk Activity API
Taskfolk Agents API
Taskfolk Attachments API
Taskfolk Automations API
Taskfolk Chat API
Taskfolk Comments API
Taskfolk Custom fields API
Taskfolk Developer API
Taskfolk Forms API
Taskfolk Goals API
Taskfolk Issues API
Taskfolk Key results API
Where this information came from

This is an independent, third-party profile of Taskfolk Docs 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.