# ClickUp — API Agent Score

> Score: 68/100 (Grade: C) | Domain: clickup.com | Rubric: 1.0.0 | Checked: July 24, 2026

ClickUp scored 68/100 (C), classified "partially-ready".

[View full report](https://www.postman.com/ai/ai-ready-apis/company/clickup)
[All organizations](https://www.postman.com/ai/ai-ready-apis/llms.txt)

## Summary

- Overall: 68/100 (C)
- Classification: partially-ready

## Category Scores

- API Design: 89/100 (A)
- Developer Experience: 69/100 (C)
- Agent Discovery: 75/100 (B)
- Agent Understanding: 81/100 (A)
- Agent Usability: 42/100 (F)

## Check Results

### API Design

- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: spec 100%, docs 100%.
- [warn] Machine-readable, versioned contract — info.version="2.0" set but no versioning scheme (URL / header / media type) detected. Investigated: spec 75%, docs 50%.
- [warn] Schema coverage & depth — 80% of operations have documented schemas (target 95%+). Investigated: spec 75%, sdk 50%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 0%.
- [pass] Example coverage — 0% example coverage. Investigated: spec 100%, docs 100%, sdk 100%.

### Developer Experience

- [pass] Self-service developer portal — Self-service signup at https://clickup.com/signup; free tier / sandbox documented. Investigated: docs 100%.
- [pass] Code samples in docs — Code samples present on 2/19 pages across 1 language(s); broader multi-language coverage missing. Investigated: docs 100%.
- [pass] Description completeness — 74% description completeness (target 90%+). Investigated: spec 100%, sdk 100%.
- [fail] Quickstart present — No quickstart/getting-started page found at the conventional paths. Investigated: docs 0%.
- [fail] Changelog published — No changelog URL or mention found in spec metadata. Investigated: spec 0%, docs 0%.

### Agent Discovery

- [pass] Registry & SDK presence — Indexed on Context7 (llmstxt/developer_clickup_llms_txt, 2637 snippets). Investigated: docs 100%, sdk 67%, cli 0%, mcp 0%, wellknown 0%.
- [warn] llms.txt present, valid & comprehensive — Could not test any pages; 50 failed to fetch. Investigated: docs 71%, sdk 0%.
- [warn] Docs reachable, not hard auth-gated — 50 JavaScript redirect(s) detected across 50 sampled pages. Investigated: docs 50%.
- [warn] Crawlable / AEO — No sitemap discoverable via robots.txt or /sitemap.xml on the docs host. Investigated: wellknown 50%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — Only 2 distinct 4xx/5xx codes documented (plus 24 "default" catch-all responses). Investigated: docs 100%, spec 50%.
- [pass] Operation purpose clarity — 93% of operations have a clear summary + operationId an agent can select on. Investigated: spec 100%.
- [warn] Agent-navigable, token-efficient docs — No sampled pages support .md URLs (0/50 tested). Investigated: docs 69%.
- [pass] Docs structured data — JSON-LD Article markup on 19/19 assessed pages (100%) with dateModified present. Investigated: docs 100%.
- [warn] Description consistency across surfaces — Mean pairwise description similarity across 3 surfaces (spec, docs, sdk) is 5% (threshold 35% for full credit).
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.

### Agent Usability

- [warn] Sandbox separation — No test-mode flag or sandbox environment is exposed. Investigated: sdk 50%, spec 0%, docs 0%.
- [fail] Idempotency documented — 0% of mutating operations document idempotency. Investigated: spec 0%, docs 0%, sdk 0%.
- [fail] Rate-limit signaling — No rate-limit response headers documented. Investigated: spec 0%, docs 0%.
- [fail] Pagination documented & consistent — 3 list endpoint(s) exist but no pagination params found. Investigated: spec 0%, docs 0%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.

## Executive Summary

ClickUp's API program shows real strengths in contract quality and documentation structure, but two areas create meaningful friction for partners and AI agents today: operational reliability and runnable truth are both entirely absent, meaning agents attempting to integrate will hit rate limits, pagination gaps, and idempotency ambiguity with no guidance — leading to broken workflows and failed integrations. A missing changelog compounds the risk by leaving partners blind to breaking changes. Prioritizing runnable, executable context and operational documentation will unblock partner integrations fastest, while adding an agent instructions file and a quickstart will ensure both humans and AI agents can get oriented without a sales conversation.