Slack Web API

{
  "service_type": "platform",
  "base_url": "https://slack.com/api",
  "auth_method": "oauth2",
  "auth_config": {
    "flows": ["authorization_code", "client_credentials"],
    "token_types": ["user", "bot", "workspace"],
    "token_endpoint": "https://slack.com/api/oauth.v2.access",
    "scopes": "Per-method OAuth scopes; granular scope selection requested at install time",
    "notes": "Tokens must be granted corresponding OAuth scopes; supports rotating tokens and refresh tokens for some app types."
  },
  "endpoints": [
    {
      "name": "Web API base",
      "url": "https://slack.com/api/{method}",
      "description": "HTTP RPC-style collection of methods invoked as POST/GET with form-encoded or JSON bodies and Bearer token auth."
    },
    {
      "name": "OAuth access",
      "url": "https://slack.com/api/oauth.v2.access",
      "description": "Exchange authorization code for access token."
    },
    {
      "name": "Conversations API",
      "url": "https://slack.com/api/conversations.*",
      "description": "List, create, join, invite, and manage channels/conversations."
    },
    {
      "name": "Chat API",
      "url": "https://slack.com/api/chat.*",
      "description": "Post, update, delete, schedule, and retrieve messages."
    },
    {
      "name": "Users API",
      "url": "https://slack.com/api/users.*",
      "description": "User profile, presence, and identity management."
    },
    {
      "name": "Files API",
      "url": "https://slack.com/api/files.*",
      "description": "Upload, list, and manage files."
    },
    {
      "name": "Reactions API",
      "url": "https://slack.com/api/reactions.*",
      "description": "Add/remove emoji reactions to messages."
    },
    {
      "name": "Events API",
      "url": "https://api.slack.com/events-api",
      "description": "Subscribe to workspace events via HTTPS callbacks or Socket Mode."
    },
    {
      "name": "Webhooks",
      "url": "https://api.slack.com/messaging/webhooks",
      "description": "Incoming webhooks for simple message posting to channels."
    }
  ],
  "pricing_model": {
    "type": "freemium",
    "details": {
      "platform_access": "Free to build and use APIs, subject to Slack workspace plan and rate limits.",
      "workspace_plans": ["Free", "Pro", "Business+", "Enterprise Grid"],
      "developer_program": "https://api.slack.com/developer-program"
    }
  },
  "rate_limits": {
    "tiered_methods": true,
    "notes": "Rate limits vary per method tier (Tier 1-4) with per-minute quotas; chat.postMessage is typically Tier 2/3. Responses include Retry-After header on 429.",
    "documentation": "https://api.slack.com/apis/rate-limits"
  },
  "capabilities": [
    "Messaging and chat automation",
    "Channel and conversation management",
    "User and presence management",
    "File uploads and sharing",
    "Emoji reactions",
    "Event subscriptions and real-time notifications",
    "Slash commands and interactive components",
    "Modals and Block Kit UI",
    "Workflow automation (Workflow Builder, Deno/TypeScript SDK)",
    "App Home and bot users",
    "Incoming/outgoing webhooks",
    "Socket Mode and HTTP request URLs",
    "Audit logs and admin APIs (Enterprise Grid)",
    "Multiple SDKs: Bolt for JS/Python/Java, Node SDK"
  ],
  "raw_analysis": "Slack Web API is a mature, well-documented HTTP RPC-style platform API that exposes hundreds of methods under https://slack.com/api/{method}. The docs site at docs.slack.dev (Docusaurus-based) serves as the developer hub, with separate guides, reference, samples, tools, changelog, and an llms.txt for LLM consumption. Authentication is OAuth 2.0-based with three token flavors (user, bot, workspace), each requiring specific OAuth scopes. The platform targets app developers building Slack integrations: bots, slash commands, workflows, and UI inside Slack (Block Kit). It has extensive SDK coverage (Bolt for JavaScript, Python, Java; official Node SDK) and supports both request/response and event-driven patterns (Events API, Socket Mode, webhooks). Maturity is high: Slack has run this platform for over a decade with stable versioning, a public changelog, and enterprise-grade features like Audit Logs and Admin APIs. Rate limits are tiered per method and enforced per workspace/app, with Retry-After semantics. Pricing is freemium at the platform level — API access is free to develop against, though the underlying workspace plan (Free/Pro/Business+/Enterprise Grid) determines feature availability and limits. The provided HTML is a Docusaurus SPA shell with no embedded API data, confirming this is documentation rather than a machine-readable spec endpoint; however, the API pattern is consistent and well-known."
}

3/3 tests passed

{
  "overall": 81,
  "dimensions": {
    "token_efficiency": 9.0,
    "first_try_success": 8.0,
    "response_parseability": 9.5,
    "error_clarity": 8.5,
    "doc_quality": 9.0,
    "auth_simplicity": 7.0,
    "latency": 7.0,
    "consistency": 9.0
  },
  "pricing_normalized": {
    "model": "freemium",
    "developer_cost": "free",
    "notes": "APIs free to use; workspace plans gate some features (Enterprise Grid admin APIs, higher limits)"
  },
  "issues": [
    "No robots.txt or llms.txt served (returns unknown_method) — agent-native discovery is missing",
    "No security headers on the docs site (only on the API endpoints)",
    "OAuth app-install dance (client_id/secret, scopes, tokens) is more involved than magic-link auth",
    "Rate limits (Tier 1-4, special limits) are complex and tier-dependent"
  ],
  "recommendations": [
    "Publish an llms.txt / agent manifest summarizing APIs, scopes, and common workflows for AI-agent onboarding",
    "Add security headers to docs site responses",
    "Surface rate-limit tiers per method in machine-readable form",
    "Provide a simplified token/app-template flow for agent-side prototyping"
  ]
}