Box Platform API

{
  "service_type": "platform",
  "base_url": "https://api.box.com/2.0",
  "auth_method": "oauth2",
  "auth_config": {
    "grant_types": ["authorization_code", "client_credentials", "refresh_token"],
    "token_url": "https://api.box.com/oauth2/token",
    "authorization_url": "https://account.box.com/api/oauth2/authorize",
    "scopes": ["root_readwrite", "manage_users", "manage_groups", "manage_enterprise", "admin", "manage_metadata", "manage_classification", "manage_content_workflows", "manage_ai", "ai_ask", "ai_text_gen", "ai_extract"]
  },
  "endpoints": [
    {
      "path": "/files",
      "method": "GET",
      "description": "List files in a folder (or all files accessible to the user/data). Uses folder_id parameter to list files within a specific folder.",
      "auth": "oauth2"
    },
    {
      "path": "/files/{file_id}",
      "method": "GET",
      "description": "Retrieve metadata and details of a specific file.",
      "auth": "oauth2"
    },
    {
      "path": "/files/{file_id}/content",
      "method": "GET",
      "description": "Download the content of a specific file.",
      "auth": "oauth2"
    },
    {
      "path": "/files/{file_id}/content",
      "method": "POST",
      "description": "Upload new content to replace an existing file.",
      "auth": "oauth2"
    },
    {
      "path": "/files/{file_id}",
      "method": "PUT",
      "description": "Update file information (e.g., rename, move, description).",
      "auth": "oauth2"
    },
    {
      "path": "/files/{file_id}",
      "method": "DELETE",
      "description": "Trash a file (move to trash folder).",
      "auth": "oauth2"
    },
    {
      "path": "/folders",
      "method": "GET",
      "description": "List folders under a specified parent folder.",
      "auth": "oauth2"
    },
    {
      "path": "/folders/{folder_id}",
      "method": "GET",
      "description": "Retrieve metadata and details of a specific folder.",
      "auth": "oauth2"
    },
    {
      "path": "/folders",
      "method": "POST",
      "description": "Create a new folder.",
      "auth": "oauth2"
    },
    {
      "path": "/folders/{folder_id}",
      "method": "PUT",
      "description": "Update folder details (rename, move).",
      "auth": "oauth2"
    },
    {
      "path": "/folders/{folder_id}",
      "method": "DELETE",
      "description": "Trash a folder.",
      "auth": "oauth2"
    },
    {
      "path": "/uploads",
      "method": "POST",
      "description": "Upload a new file (multipart upload).",
      "auth": "oauth2"
    },
    {
      "path": "/search",
      "method": "GET",
      "description": "Search for files and folders in enterprise content.",
      "auth": "oauth2"
    },
    {
      "path": "/metadata_templates",
      "method": "GET",
      "description": "List metadata templates available (enterprise-level).",
      "auth": "oauth2"
    },
    {
      "path": "/metadata_templates/{scope}",
      "method": "POST",
      "description": "Create a metadata template with attributes (in a given scope).",
      "auth": "oauth2"
    },
    {
      "path": "/metadata_templates/{scope}/{templateKey}",
      "method": "GET",
      "description": "Retrieve a specific metadata template schema.",
      "auth": "oauth2"
    },
    {
      "path": "/metadata_templates/{scope}/{templateKey}/schema",
      "method": "PUT",
      "description": "Update a metadata template schema (add fields).",
      "auth": "oauth2"
    },
    {
      "path": "/metadata_templates/{scope}/{templateKey}",
      "method": "DELETE",
      "description": "Delete a metadata template (cascade may be possible).",
      "auth": "oauth2"
    },
    {
      "path": "/files/{file_id}/metadata/{scope}{template}",
      "method": "GET",
      "description": "Retrieve metadata applied to a specific file.",
      "auth": "oauth2"
    },
    {
      "path": "/files/{file_id}/metadata/{scope}{template}",
      "method": "POST",
      "description": "Apply a metadata template to a file (create metadata instance).",
      "auth": "oauth2"
    },
    {
      "path": "/files/{file_id}/metadata/{scope}{template}",
      "method": "PUT",
      "description": "Update metadata values on a file.",
      "auth": "oauth2"
    },
    {
      "path": "/files/{file_id}/metadata/{scope}{template}",
      "method": "DELETE",
      "description": "Remove metadata template from a file.",
      "auth": "oauth2"
    },
    {
      "path": "/classifications",
      "method": "GET",
      "description": "List classification templates available (security policy).",
      "auth": "oauth2"
    },
    {
      "path": "/classifications",
      "method": "POST",
      "description": "Create a classification template.",
      "auth": "oauth2"
    },
    {
      "path": "/files/{file_id}/metadata/global/boxSecurityClassificationKey",
      "method": "GET",
      "description": "Retrieve classification metadata for a file.",
      "auth": "oauth2"
    },
    {
      "path": "/users",
      "me

3/3 tests passed

```json
{
  "overall": 55,
  "dimensions": {
    "token_efficiency": 7.0,
    "first_try_success": 5.0,
    "response_parseability": 6.0,
    "error_clarity": 6.0,
    "doc_quality": 8.0,
    "auth_simplicity": 2.0,
    "latency": 9.0,
    "consistency": 5.0
  },
  "pricing_normalized": {},
  "issues": [
    "No capability or pricing information extracted from platform analysis",
    "No authentication/SSO method documented or evaluated",
    "Enterprise developer platform (Box) likely requires app registration, keys, and potentially admin approval — steep onboarding for agents",
    "No evidence of simple token or API-key setup; enterprise OAuth flows are typical",
    "Multiple latency checks but no functional endpoint tested; only homepage and static files"
  ],
  "recommendations": [
    "Document a clear quick-start for agents: API key generation, first API call within 5 minutes",
    "Provide a sample curl/HTTP request that agents can use verbatim",
    "List all authentication requirements prominently (client_id, client_secret, token endpoint)",
    "Add pricing page / free tier details to llms.txt for agent consumption",
    "Evaluate functional API latency (e.g., /users/me) rather than just static page loads"
  ]
}
```