{"success": true, "provider": "protoboard", "platform": "Protoboard", "version": "1.0.0", "description": "Agent-first API platform for AI systems", "domains": {"support": {"name": "Support", "description": "Customer support ticket management", "actions": {"ticket": {"create": {"description": "Create a new support ticket", "method": "POST", "path": "/api/support/ticket/create", "schema": {"subject": {"type": "string", "required": true, "max_length": 300}, "body_text": {"type": "string", "required": false}, "body_html": {"type": "string", "required": false}, "priority": {"type": "string", "choices": ["low", "medium", "high", "urgent"], "default": "medium"}, "requester_email": {"type": "string", "required": true}, "requester_name": {"type": "string", "required": false}, "tags": {"type": "array", "items": {"type": "string"}, "required": false}}, "response": {"id": {"type": "string", "format": "uuid"}, "subject": {"type": "string"}, "body_text": {"type": "string"}, "body_html": {"type": "string"}, "status": {"type": "string"}, "priority": {"type": "string"}, "requester_email": {"type": "string"}, "requester_name": {"type": "string"}, "assigned_to_email": {"type": "string"}, "assigned_to_name": {"type": "string"}, "tags": {"type": "array", "items": {"type": "string"}}, "source": {"type": "string"}, "created_at": {"type": "string", "format": "iso8601"}, "updated_at": {"type": "string", "format": "iso8601"}}}, "get": {"description": "Get a specific ticket by ID", "method": "GET", "path": "/api/support/ticket/get/{ticket_id}", "schema": {"ticket_id": {"type": "string", "required": true, "format": "uuid"}}, "response": {"id": {"type": "string", "format": "uuid"}, "subject": {"type": "string"}, "body_text": {"type": "string"}, "body_html": {"type": "string"}, "status": {"type": "string"}, "priority": {"type": "string"}, "requester_email": {"type": "string"}, "requester_name": {"type": "string"}, "assigned_to_email": {"type": "string"}, "assigned_to_name": {"type": "string"}, "tags": {"type": "array", "items": {"type": "string"}}, "source": {"type": "string"}, "created_at": {"type": "string", "format": "iso8601"}, "updated_at": {"type": "string", "format": "iso8601"}}}, "list": {"description": "List tickets with optional filtering", "method": "GET", "path": "/api/support/ticket/list", "schema": {"status": {"type": "string", "choices": ["open", "in_progress", "resolved", "closed"], "required": false}, "priority": {"type": "string", "choices": ["low", "medium", "high", "urgent"], "required": false}, "assigned_to": {"type": "string", "format": "email", "required": false}, "tags": {"type": "array", "items": {"type": "string"}, "required": false}, "limit": {"type": "integer", "min": 1, "max": 100, "default": 20}, "offset": {"type": "integer", "min": 0, "default": 0}}, "response": {"tickets": {"type": "array", "items": {"type": "object", "properties": {"id": {"type": "string", "format": "uuid"}, "subject": {"type": "string"}, "body_text": {"type": "string"}, "body_html": {"type": "string"}, "status": {"type": "string"}, "priority": {"type": "string"}, "requester_email": {"type": "string"}, "requester_name": {"type": "string"}, "assigned_to_email": {"type": "string"}, "assigned_to_name": {"type": "string"}, "tags": {"type": "array", "items": {"type": "string"}}, "source": {"type": "string"}, "created_at": {"type": "string", "format": "iso8601"}, "updated_at": {"type": "string", "format": "iso8601"}}}}, "total": {"type": "integer"}, "limit": {"type": "integer"}, "offset": {"type": "integer"}}}, "update": {"description": "Update ticket status, priority, assignee, or tags", "method": "PATCH", "path": "/api/support/ticket/update/{ticket_id}", "schema": {"ticket_id": {"type": "string", "required": true, "format": "uuid"}, "status": {"type": "string", "choices": ["open", "in_progress", "resolved", "closed"], "required": false}, "priority": {"type": "string", "choices": ["low", "medium", "high", "urgent"], "required": false}, "assigned_to": {"type": "string", "format": "email", "required": false}, "tags": {"type": "array", "items": {"type": "string"}, "required": false}}, "response": {"id": {"type": "string", "format": "uuid"}, "subject": {"type": "string"}, "body_text": {"type": "string"}, "body_html": {"type": "string"}, "status": {"type": "string"}, "priority": {"type": "string"}, "requester_email": {"type": "string"}, "requester_name": {"type": "string"}, "assigned_to_email": {"type": "string"}, "assigned_to_name": {"type": "string"}, "tags": {"type": "array", "items": {"type": "string"}}, "source": {"type": "string"}, "created_at": {"type": "string", "format": "iso8601"}, "updated_at": {"type": "string", "format": "iso8601"}}}}, "comment": {"create": {"description": "Add a comment to a ticket", "method": "POST", "path": "/api/support/comment/create", "schema": {"ticket_id": {"type": "string", "required": true, "format": "uuid"}, "body_text": {"type": "string", "required": true}, "body_html": {"type": "string", "required": false}, "author_email": {"type": "string", "required": true}, "author_name": {"type": "string", "required": false}, "is_internal": {"type": "boolean", "default": false}}, "response": {"id": {"type": "string", "format": "uuid"}, "ticket_id": {"type": "string", "format": "uuid"}, "body_text": {"type": "string"}, "body_html": {"type": "string"}, "author_email": {"type": "string"}, "author_name": {"type": "string"}, "is_internal": {"type": "boolean"}, "source": {"type": "string"}, "created_at": {"type": "string", "format": "iso8601"}, "updated_at": {"type": "string", "format": "iso8601"}}}, "get": {"description": "Get a specific comment by ID", "method": "GET", "path": "/api/support/comment/get/{comment_id}", "schema": {"comment_id": {"type": "string", "required": true, "format": "uuid"}}, "response": {"id": {"type": "string", "format": "uuid"}, "ticket_id": {"type": "string", "format": "uuid"}, "body_text": {"type": "string"}, "body_html": {"type": "string"}, "author_email": {"type": "string"}, "author_name": {"type": "string"}, "is_internal": {"type": "boolean"}, "source": {"type": "string"}, "created_at": {"type": "string", "format": "iso8601"}, "updated_at": {"type": "string", "format": "iso8601"}}}, "list": {"description": "List comments for a ticket", "method": "GET", "path": "/api/support/comment/list", "schema": {"ticket_id": {"type": "string", "required": true, "format": "uuid"}, "limit": {"type": "integer", "min": 1, "max": 100, "default": 20}, "offset": {"type": "integer", "min": 0, "default": 0}}, "response": {"comments": {"type": "array", "items": {"type": "object", "properties": {"id": {"type": "string", "format": "uuid"}, "ticket_id": {"type": "string", "format": "uuid"}, "body_text": {"type": "string"}, "body_html": {"type": "string"}, "author_email": {"type": "string"}, "author_name": {"type": "string"}, "is_internal": {"type": "boolean"}, "source": {"type": "string"}, "created_at": {"type": "string", "format": "iso8601"}, "updated_at": {"type": "string", "format": "iso8601"}}}}, "total": {"type": "integer"}, "limit": {"type": "integer"}, "offset": {"type": "integer"}}}}, "email": {"send": {"description": "Send email from ticket using account-specific subdomain (e.g., support@company.protoboard.io)", "method": "POST", "path": "/api/support/email/send", "schema": {"ticket_id": {"type": "string", "required": true, "format": "uuid"}, "to_email": {"type": "string", "required": true, "format": "email"}, "subject": {"type": "string", "required": false, "max_length": 300}, "body_text": {"type": "string", "required": true}, "body_html": {"type": "string", "required": false}}, "response": {"success": {"type": "boolean"}, "comment_id": {"type": "string", "format": "uuid"}, "message_id": {"type": "string"}}}}, "email_settings": {"get": {"description": "Get email configuration and subdomain authentication status", "method": "GET", "path": "/api/support/email/settings", "schema": {}, "response": {"email_subdomain": {"type": "string"}, "support_email": {"type": "string"}, "is_configured": {"type": "boolean"}, "auth_status": {"type": "string", "choices": ["none", "pending", "authenticated", "failed"]}, "auth_error": {"type": "string"}}}, "update_subdomain": {"description": "Update email subdomain and trigger SendGrid authentication", "method": "POST", "path": "/api/support/email/settings/subdomain", "schema": {"subdomain": {"type": "string", "required": true, "min_length": 3, "max_length": 63, "pattern": "^[a-z0-9-]+$"}}, "response": {"email_subdomain": {"type": "string"}, "support_email": {"type": "string"}, "is_configured": {"type": "boolean"}}}}}}}, "authentication": {"type": "api_key", "format": "pb_xxxxxxxxxxxxxxxxxxxxxxxxxxxx", "header": "X-API-Key", "alternative_header": "Authorization: Bearer <key>", "query_param": "api_key"}, "rate_limits": {"free": 100, "starter": 1000, "pro": 10000, "enterprise": 100000}, "error_format": {"success": "boolean", "code": "string", "message": "string", "details": "object"}}