> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anny.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Register display panel

> Register a new display panel for the organization. Returns the panel record along with a one-time pairing code and public URL used to activate the panel display.

Requires a Bearer token.



## OpenAPI

````yaml /developers/openapi/additional-internal.openapi.json post /api/v1/display-panels
openapi: 3.1.0
info:
  title: Additional Internal API
  version: '1.0'
servers:
  - url: https://b.anny.co
    description: Production
  - url: https://b.anny.eu
    description: Gov-Cloud
security: []
paths:
  /api/v1/display-panels:
    post:
      tags:
        - Display Panels
      summary: Register display panel
      description: >-
        Register a new display panel for the organization. Returns the panel
        record along with a one-time pairing code and public URL used to
        activate the panel display.


        Requires a Bearer token.
      operationId: post-display-panels
      parameters:
        - schema:
            type: string
          in: header
          name: Authorization
          description: Bearer Token
          required: true
        - schema:
            type: string
          in: query
          name: o
          description: Organization ID
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                data:
                  type: object
                  properties:
                    type:
                      type: string
                      default: display-panels
                    attributes:
                      type: object
                      required:
                        - panel_type
                      properties:
                        panel_type:
                          type: string
                          enum:
                            - app
                          description: Panel type — use `app` for the anny display app
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/display-panels.v1'
                  meta:
                    type: object
                    properties:
                      pairing_code:
                        type: string
                        description: One-time code to pair the display device
                      pairing_expires_at:
                        type: string
                        format: date-time
                        description: When the pairing code expires
                      public_url:
                        type: string
                        format: uri
                        description: Public URL of the registered display panel
        '401':
          description: Unauthorized
        '422':
          description: Unprocessable Entity
      security:
        - Bearer: []
components:
  schemas:
    display-panels.v1:
      $schema: https://json-schema.org/draft/2020-12/schema
      x-version: 1.1.0
      title: DisplayPanel
      type: object
      description: A panel widget on a display showing specific content.
      x-tags:
        - Models
      properties:
        id:
          type: string
        type:
          type: string
          default: displaypanels
        attributes:
          type: object
          properties:
            panel_type:
              type: string
              description: Panel type
            layout:
              type: object
              description: Panel layout configuration
            order_index:
              type: integer
              description: Display order
            background_color:
              type:
                - string
                - 'null'
              description: Background color
            accent_color:
              type:
                - string
                - 'null'
              description: Accent color
            text_color:
              type:
                - string
                - 'null'
              description: Text color
            timezone:
              type: string
              description: Timezone
            created_at:
              type: string
              description: Creation timestamp
        links:
          $ref: '#/components/schemas/links.v1'
        relationships:
          type: object
          properties:
            display:
              type: object
              description: Parent display
              properties:
                data:
                  type:
                    - object
                    - 'null'
                  properties:
                    type:
                      type: string
                    id:
                      type: string
                links:
                  $ref: '#/components/schemas/links.v1'
    links.v1:
      $schema: https://json-schema.org/draft/2020-12/schema
      x-version: 1.1.0
      title: ResourceLinks
      x-tags:
        - Models
      type: object
      description: JSON:API self-link object
      properties:
        self:
          type: string
          format: uri
  securitySchemes:
    Bearer:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://auth.anny.co/oauth/authorize
          tokenUrl: https://auth.anny.co/oauth/token
          refreshUrl: https://auth.anny.co/oauth/token/refresh
          scopes: {}

````