Developer Portal
Quick StartsComposition scriptingAPIs and SDKsSupport
  • Portal overview
  • Quick start
  • REST API
    • Introduction
    • Rate limits
    • Authorization
    • How-to guides
      • Get a control app's API token
      • Get a composition's sub-composition IDs and names and their payload structures
      • Get a control app's model
      • Get a control app's metadata
      • Update a sub-composition's content
      • Update a sub-composition's animation state
      • Update a sub-composition's content and animation state in one call
      • Update multiple sub-compositions in one call
    • API reference
      • Get control app details
        • Get a control app's metadata
        • Get a control app's model
        • Get a control app's control data
      • Send data to a control app
        • Update a control app's content
        • Update a control app's animation state
      • Take out all of an app's output
  • Data stream API
    • Introduction
    • Rate limits
    • Authorization
    • How-to guides
      • Create a data stream
      • Link a data stream to a composition
      • Send data to an app using the data stream API
    • API reference
  • Composition scripting
    • Introduction
    • Overview
    • Quick start
      • Find sub-compositions and widgets
      • Read and update control nodes
      • Set text widget text properties
      • Read and update widget properties
      • Read control nodes and update widget properties
      • Set image widget URL property
      • Set table widget content property
    • Cheat sheets
      • Fundamentals
      • Interactive overlays
      • Best practices
    • Use cases
      • Read control nodes and generate HTML text
      • Read control nodes, generate HTML text with background
      • Text Ticker - Start ticker on "In" animation
    • Composition script editor reference
  • Software development kits
    • Graphics SDK
      • Getting started
      • Reference
        • SDK functions
        • Composition object
        • Sequencer object
      • Guides and examples
        • Load a composition with its token
        • Load a composition with its URL
        • Get the composition URL of an app instance
        • Sequencer VOD example
        • Control local preview of app
        • Load app instance output
    • Overlay SDK
      • Getting started
      • SDK functions
      • Use case examples
    • Widget SDK
      • Preparing your environment
      • Getting started
      • Reference
        • Widget UI definition
        • Widget callback functions
        • Time control object
        • Composition instance
      • Guides and examples
        • Widget example: CSS patterns
    • App SDK
  • Singular Basics
    • Overview of Singular
    • Managing overlays in the Dashboard
      • How to create a new composition
      • How to open a new app template
      • How to create an app for a composition
      • How to extract a composition from an app
      • How to find an app's shared app token and shared API URL
      • Dashboard reference
    • Building overlays in Composer
      • How to build a composition
      • How to set up layer logic to automate overlay transitions
      • How to set up control nodes to make widget properties available to a control app
      • Animating overlays
        • How to create timeline animations
        • How to create behavior animations
        • How to create update animations
      • How to make overlays interactive
      • How to adapt overlays to various screen sizes
      • Composer reference
    • Controlling overlays in Studio and UNO
      • How to use Studio
      • Studio reference
      • UNO reference
  • Support
    • Singular status
    • Support resources
    • Singular terminology
    • Performance Testing
Powered by GitBook
On this page

Was this helpful?

  1. REST API
  2. How-to guides

Get a control app's metadata

PreviousGet a control app's modelNextUpdate a sub-composition's content

Last updated 2 years ago

Was this helpful?

An app's metadata includes its Dashboard information and URLs.

To get a control app's metadata:

  1. .

  2. Send a GET request to the endpoint for , https://app.singular.live/apiv2/controlapps/:appToken replacing :appToken with the app token for your app instance.

The response should look like this:

The control app's metadata:
{
    "id": 1689254,
    "userId": 25290,
    "accountId": 22123,
    "thumbnail": "//image.singular.live/fit-in/150x150/7072b13f9e20b98034f48d6202400ff9/images/2uxfaGbSr90q1Xk35HSFX2.jpg",
    "updatedAt": "2022-10-07T08:12:20.000Z",
    "createdAt": "2022-10-07T04:27:59.000Z",
    "type": "controlapp",
    "outputUrl": "https://app.singular.live/output/2xD4oI77sW2KIbNugYoZYD/Output?aspect=16:9",
    "broadcastOutputUrl": "https://app.singular.live/output/2xD4oI77sW2KIbNugYoZYD/Broadcast?aspect=16:9",
    "publicControlUrl": "https://app.singular.live/control/6tM4SnlHlWp9Ll1iBNozQd",
    "publicControlApiUrl": "https://app.singular.live/apiv2/controlapps/6tM4SnlHlWp9Ll1iBNozQd/control",
    "publicCommandApiUrl": "https://app.singular.live/apiv2/controlapps/6tM4SnlHlWp9Ll1iBNozQd/command",
    "publicModelApiUrl": "https://app.singular.live/apiv2/controlapps/6tM4SnlHlWp9Ll1iBNozQd/model",
    "appTemplateId": 518,
    "appTemplateVersion": 10,
    "name": "UNO Lowers | Momentum",
    "folder": "5389373f-f476-4cdc-99c8-0593c046c5a3",
    "compositionId": 441440
}
Get the control app's app token
Get a control app's metadata