# Wallboard Digital Signage API
> Enterprise digital signage CMS platform for managing devices, content, and campaigns

## Overview
Wallboard is a digital signage content management system. The API uses OAuth 2.0 authentication
and follows REST conventions. Most management endpoints use `/api/`; OAuth uses `/oauth/`.

## Machine-Readable API Documentation
OpenAPI specifications and the [domain index](https://docs.wallboard.us/openapi/index.yaml):

- [Administration](https://docs.wallboard.us/openapi/administration.yaml): 35 operations
- [Advertisers](https://docs.wallboard.us/openapi/advertisers.yaml): 9 operations
- [AI](https://docs.wallboard.us/openapi/ai.yaml): 6 operations
- [Alerts & Notifications](https://docs.wallboard.us/openapi/alerts.yaml): 14 operations
- [Authentication](https://docs.wallboard.us/openapi/authentication.yaml): 3 operations
- [Channel/Schedule](https://docs.wallboard.us/openapi/campaigns.yaml): 18 operations
- [Content Management](https://docs.wallboard.us/openapi/content.yaml): 40 operations
- [Customer-owned Apps](https://docs.wallboard.us/openapi/custom-apps.yaml): 6 operations
- [Datasources](https://docs.wallboard.us/openapi/datasources.yaml): 26 operations
- [Device Metrics](https://docs.wallboard.us/openapi/device-metrics.yaml): 2 operations
- [Device Management](https://docs.wallboard.us/openapi/devices.yaml): 82 operations
- [File Management](https://docs.wallboard.us/openapi/files.yaml): 37 operations
- [Getting Started](https://docs.wallboard.us/openapi/getting-started.yaml): 0 operations
- [MCP Integration](https://docs.wallboard.us/openapi/mcp.yaml): 0 operations
- [Quick Filters](https://docs.wallboard.us/openapi/quick-filters.yaml): 7 operations
- [Statistics](https://docs.wallboard.us/openapi/statistics.yaml): 18 operations
- [User & Team Management](https://docs.wallboard.us/openapi/users.yaml): 33 operations
- [Webhooks](https://docs.wallboard.us/openapi/webhooks.yaml): 12 operations

## Quick Start
1. Authenticate via OAuth 2.0 to get a Bearer token
2. Include `Authorization: Bearer <token>` header in all requests
3. Use `customerId` parameter for multi-tenant operations


## API Reference (AI-Optimized Documentation)
Machine-readable API documentation optimized for AI assistants:

- [Api Conventions](https://docs.wallboard.us/api-reference/api-conventions.md): Multi-tenancy, response conventions, flat API, error handling
- [Authentication](https://docs.wallboard.us/api-reference/authentication.md): OAuth 2.0 flows (PKCE and client_secret), token handling
- [Core Concepts](https://docs.wallboard.us/api-reference/core-concepts.md): Platform overview, content types, delivery methods, scheduling
- [Examples](https://docs.wallboard.us/api-reference/examples.md): Common use-case queries, practical examples
- [Query Params](https://docs.wallboard.us/api-reference/query-params.md): Pagination, sorting, select parameter
- [Terminology](https://docs.wallboard.us/api-reference/terminology.md): UI to API term mapping, entity relationships
- [Wbql](https://docs.wallboard.us/api-reference/wbql.md): Query language syntax, operators, filtering patterns
## Human-Readable Documentation
- [Getting Started Guide](https://docs.wallboard.us/docs/api/getting-started/)
- [Full Documentation](/)

## Platform Architecture Documentation
Technical documentation explaining how Wallboard works internally. Useful for AI assistants and developers building integrations.

### Content System
- [Channels](https://docs.wallboard.us/platform/content/channels.md): Channel architecture, playback logic, balancing, sub-channels
- [Content Editor](https://docs.wallboard.us/platform/content/content-editor.md): Editor components, widgets, templates
- [Scheduling](https://docs.wallboard.us/platform/content/scheduling.md): Time-based content scheduling
- [Content Actions](https://docs.wallboard.us/platform/content/content-action-system.md): Action system architecture

### Data Sources
- [Core Architecture](https://docs.wallboard.us/platform/datasources/core_datasource_architecture.md): Datasource system overview
- [External Sources](https://docs.wallboard.us/platform/datasources/external-datasource-complete.md): Google Sheets, Excel, RSS, databases
- [Data Binding](https://docs.wallboard.us/platform/datasources/data-binding.md): Binding data to content widgets
- [AI Datasources](https://docs.wallboard.us/platform/datasources/ai-datasources.md): AI-powered data sources
- [Cloud Credentials](https://docs.wallboard.us/platform/datasources/cloud_credentials_system.md): OAuth, API keys management
- [Internal Actions](https://docs.wallboard.us/platform/datasources/internal-datasource-actions.md): Internal datasource operations

### Devices
- [Device Management](https://docs.wallboard.us/platform/devices/device-management.md): Device lifecycle, registration, sync, commands

### Features
- [Notifications](https://docs.wallboard.us/platform/features/notifications.md): Alert and notification system
- [Proof of Play](https://docs.wallboard.us/platform/features/proof-of-play.md): Analytics and playback reporting
- [Quick Filters](https://docs.wallboard.us/platform/features/quick-filters.md): WBQL-based filtering system
- [Shared Folders](https://docs.wallboard.us/platform/features/shared_folders.md): Cross-team content sharing
- [User Management](https://docs.wallboard.us/platform/features/user-management.md): Users, teams, permissions

### System
- [Infrastructure](https://docs.wallboard.us/platform/system/backend-infrastructure.md): Backend architecture overview
- [Security](https://docs.wallboard.us/platform/system/security.md): Security model and practices
- [Compliance](https://docs.wallboard.us/platform/system/compliance.md): Regulatory compliance
- [General](https://docs.wallboard.us/platform/system/general.md): General system information