# Yoofooz API Readiness Report

## API
**Name:** Linear API
**Docs URL:** https://linear.app/docs/api-and-webhooks
**Domain:** linear.app
**Generated At:** 2026-10-05T22:34:25.213268+00:00

## Certification
**Agent Readiness Score:** 75/100
**Certification Level:** Yoofooz Ready

## Agent Commerce Readiness
**Agent Commerce Score:** 40/100
**Agent Commerce Level:** Agent Commerce Emerging

This score is separate from the core Agent Readiness Score and evaluates MCP support, scoped agent identity, machine-native payments, consumption pricing, budget controls, rate controls, deterministic errors, auditability, least-privilege security, and agent observability.

## Category Scores
- Documentation Clarity: 10
- Machine Readable Spec: 10
- Authentication Clarity: 10
- Error Handling: 10
- Rate Limit Clarity: 10
- Agent Safe Workflow Support: 0
- Sandbox Availability: 0
- Webhook Event Support: 10
- Commercial Trust: 5
- Developer Experience: 10

## Strengths
- Documentation clarity
- Machine-readable specification (OpenAPI/GraphQL/etc.)
- Authentication model clarity
- Error handling and status codes
- Rate-limit / quota behavior
- Webhook / event support
- Developer experience (SDKs, quickstart, CLI)

## Risks
- Agent-safe workflow primitives (idempotency, retries) signal not detected in docs.
- Sandbox / test-mode availability signal not detected in docs.
- Commercial trust (status, SLA, compliance) signal is partial; clearer documentation recommended.

## Recommended Next Steps
- Document idempotency keys, test mode, dry runs, and safe retry semantics for agents.
- Provide a sandbox / test mode with test API keys for safe agent testing.
- Strengthen: Publish status page, SLA, and security/compliance posture (SOC 2, GDPR, PCI as applicable).

## Evidence Signals

### Documentation clarity
- **Source:** https://linear.app/developers/oauth-2-0-authentication
- **Matched:** getting started, parameters, request, response, docs, guide
- **Evidence:** "skip to content → developers sign up open app graphql api getting started pagination filtering rate limiting deprecations webhooks attachments managing customers graphql schema ↗ authentication oauth 2.0 authentication..."

- **Source:** https://linear.app/developers/rate-limiting
- **Matched:** getting started, parameters, request, response, docs, guide
- **Evidence:** "skip to content → developers sign up open app graphql api getting started pagination filtering rate limiting deprecations webhooks attachments managing customers graphql schema ↗ authentication oauth 2.0 authentication..."

### Machine-readable specification (OpenAPI/GraphQL/etc.)
- **Source:** https://linear.app/developers/webhooks
- **Matched:** graphql schema, endpoints, schema, graphql, schema explorer
- **Evidence:** "...→ developers sign up open app graphql api getting started pagination filtering rate limiting deprecations webhooks attachments managing customers graphql schema ↗ authentication oauth 2.0 authentication oauth actor authorization oauth application manifests file storage authentication agents agent interaction..."

- **Source:** https://linear.app/developers/oauth-2-0-authentication
- **Matched:** graphql schema, endpoints, schema, graphql
- **Evidence:** "...→ developers sign up open app graphql api getting started pagination filtering rate limiting deprecations webhooks attachments managing customers graphql schema ↗ authentication oauth 2.0 authentication oauth actor authorization oauth application manifests file storage authentication agents agent interaction..."

### Authentication model clarity
- **Source:** https://linear.app/developers/oauth-2-0-authentication
- **Matched:** oauth, access token, client secret, scopes, authentication, authorization, api key
- **Evidence:** "...graphql api getting started pagination filtering rate limiting deprecations webhooks attachments managing customers graphql schema ↗ authentication oauth 2.0 authentication oauth actor authorization oauth application manifests file storage authentication agents agent interaction guidelines (aig)..."

- **Source:** https://linear.app/docs/mcp
- **Matched:** bearer token, oauth, access token, authentication, authorization, api key, keys
- **Evidence:** "...at the following address. the interactive setup flow uses oauth 2.1 with dynamic client registration. you can also authenticate directly with a bearer token or linear api key — see the faq for details. read-write access is provided through https://mcp.linear.app/mcp by default. for read-only access, you..."

### Error handling and status codes
- **Source:** https://linear.app/developers/rate-limiting
- **Matched:** 400, 404, 500, errors
- **Evidence:** "...the time at which the current rate limit window resets in utc epoch milliseconds . when authenticated using an api key you can make up to 2,500 requests per hour . requests are associated with the authenticated user, which means all requests by the same user share the same quota even when..."

- **Source:** https://linear.app/developers/oauth-2-0-authentication
- **Matched:** 400, 401, errors
- **Evidence:** "...should use the token field. the token field must not be combined with legacy fields. response ⁠ expected http status: 200 - token was revoked 400 - unable to revoke token (e.g. token was already revoked) 401 - unable to authenticate with the token rotating your client secret ⁠ if your..."

### Rate-limit / quota behavior
- **Source:** https://linear.app/developers/rate-limiting
- **Matched:** rate limit, rate limits, quota, limits
- **Evidence:** "skip to content → developers sign up open app graphql api getting started pagination filtering rate limiting deprecations webhooks attachments managing customers graphql schema ↗ authentication oauth 2.0 authentication oauth actor authorization oauth..."

- **Source:** https://linear.app/developers/webhooks
- **Matched:** rate limit
- **Evidence:** "skip to content → developers sign up open app graphql api getting started pagination filtering rate limiting deprecations webhooks attachments managing customers graphql schema ↗ authentication oauth 2.0 authentication oauth actor authorization oauth..."

### Webhook / event support
- **Source:** https://linear.app/developers/oauth-2-0-authentication
- **Matched:** webhooks, signing secret, webhook, events, callback
- **Evidence:** "skip to content → developers sign up open app graphql api getting started pagination filtering rate limiting deprecations webhooks attachments managing customers graphql schema ↗ authentication oauth 2.0 authentication oauth actor authorization oauth application manifests file..."

- **Source:** https://linear.app/developers/webhooks
- **Matched:** webhooks, signing secret, webhook, events
- **Evidence:** "skip to content → developers sign up open app graphql api getting started pagination filtering rate limiting deprecations webhooks attachments managing customers graphql schema ↗ authentication oauth 2.0 authentication oauth actor authorization oauth application manifests file..."

### Commercial trust (status, SLA, compliance)
- **Source:** https://linear.app/docs/api-and-webhooks
- **Matched:** support, security
- **Evidence:** "...issues issue properties projects initiatives cycles views find and filter linear asks integrations analytics importers docs developers learn contact support administration api and webhooks copy page sign up open app api and webhooks linear’s graphql api and webhooks lets you extend linear’s functionality..."

- **Source:** https://linear.app/docs/mcp
- **Matched:** support, security
- **Evidence:** "...intercom jira microsoft teams notion salesforce sentry slack zapier zendesk diffs integrations analytics importers docs developers learn contact support ai mcp server copy page sign up open app mcp server the model context protocol (mcp) server provides a standardized interface that allows any..."

### Developer experience (SDKs, quickstart, CLI)
- **Source:** https://linear.app/developers/webhooks
- **Matched:** sdk, cli, guides
- **Evidence:** "...agents agent interaction guidelines (aig) getting started developing the agent interaction interaction best practices signals typescript sdk getting started fetching & modifying data errors advanced usage webhooks migrating from 1.x to 2.x github ↗ guides how to upload a file to linear..."

- **Source:** https://linear.app/developers/oauth-2-0-authentication
- **Matched:** sdk, cli, guides
- **Evidence:** "...agents agent interaction guidelines (aig) getting started developing the agent interaction interaction best practices signals typescript sdk getting started fetching & modifying data errors advanced usage webhooks migrating from 1.x to 2.x github ↗ guides how to upload a file to linear..."

## AI Analyst Summary
AI analysis unavailable: NVIDIA analysis failed: http 410

## Yoofooz Summary
This API has been evaluated for autonomous AI-agent usability. The score reflects documentation quality, machine-readable specification signals, authentication clarity, error handling, workflow safety, commercial trust, and developer experience.