Skip to content
Tilecast Docs

createAirplaySession

POST
/api/v1/airplay/sessions
curl --request POST \
  --url https://example.com/api/v1/airplay/sessions \
  --header 'Content-Type: application/json' \
  --data '{ "targetType": "screen", "targetId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "durationMinutes": 0, "transport": "auto", "audioMode": "gateway_only" }'

Start a temporary AirPlay Present session on a screen or screen group. Requires an Owner or Administrator with the write scope. Cookie-authenticated unsafe requests require X-CSRF-Token.

Parameters

Section titled “ Parameters ”

Header Parameters

Section titled “Header Parameters”
X-CSRF-Token
string

Cookie-backed browser requests only, and only on unsafe methods. Bearer grants never send it.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
targetType
required
string
Allowed values: screen group
targetId
required
string format: uuid
durationMinutes

Zero runs until stopped.

integer
Allowed values: 0 15 30 60
transport
string
Allowed values: auto unicast multicast
audioMode
string
Allowed values: gateway_only none

Responses

Section titled “ Responses ”

202

Section titled “202”

AirPlay session accepted

Media typeapplication/json
object
data
required

Temporary AirPlay Present session. The PIN appears only while the session is preparing, waiting, or active, and only when the server issued one. Null audio and network ids mean no audio screen and no Presentation Network, respectively.

object
id
required
string format: uuid
provider
required
string
Allowed values: airplay
status
required
string
Allowed values: preparing waiting active stopping ended expired failed
targetType
required
string
Allowed values: screen group
targetId
required
string format: uuid
gatewayScreenId
required
string format: uuid
audioScreenId
required
string | null format: uuid
receiverName
required
string
pin
string
expiresAt
required
string format: date-time
createdAt
required
string format: date-time
endedAt
string | null format: date-time
endReason
required
string
transport
required
string
Allowed values: auto unicast multicast
videoProfile
required
string
audioMode
required
string
Allowed values: gateway_only none
presentationNetworkId
required
string | null format: uuid
presentationNetworkName
required
string
screenCount
required
integer
readyCount
required
integer
connectedCount
required
integer
failedCount
required
integer
screens
required
Array<object>
object
screenId
required
string format: uuid
screenName
required
string
role
required
string
state
required
string
lastUpdatedAt
required
string format: date-time
failureCode
string
failureMessage
string
presentationNetworkState
string
Example
{
  "data": {
    "provider": "airplay",
    "status": "preparing",
    "targetType": "screen",
    "transport": "auto",
    "audioMode": "gateway_only"
  }
}

400

Section titled “400”

Invalid request body

401

Section titled “401”

Dashboard authentication required

403

Section titled “403”

Insufficient role or screen scope

409

Section titled “409”

Selected displays already have an active session

422

Section titled “422”

Target, duration, transport, or readiness invalid