---
title: Process a Play Media Intent
framework: SiriKit Cloud Media
role: symbol
role_heading: Web Service Endpoint
platforms: [sirikit cloud media 1.0.2+]
path: sirikitcloudmedia/playmedia-1g2o9
---

# Process a Play Media Intent

Interpret the user’s request to play a media item, and provide instructions to access a corresponding playback queue.

## URL

POST https://cloudextension-testservice.local/api/intent/playMedia

## Header Parameters

Accept-Language: The client’s current user interface language. Respond with localized content for this language, if available. Request-Timeout: An approximate deadline, in seconds, for processing this real-time user request. The Session object provides the exact deadline for handling an intent. User-Agent: The extension protocol running on the client. This is an RFC 7231-compliant string that contains the product name AppleCloudExtension and the SiriKit Extension library version running on the client. x-applecloudextension-retry-count: The number of previous requests from the client. The client omits this header on the first attempt. x-applecloudextension-session-id: A constant session identifier to include in each request and response. Respond to each request with the session ID the client sends in that request.

## Response Codes

200 OK: The request is successful.

## Discussion

Discussion Processing a play media request requires a few steps: Resolve the intended media item. Resolve any playback customizations, such as repeat mode. Handle the intent. Provide a playback queue. You can improve the overall response time to the user’s request by providing a response for resolving any playback customizations, and handling the intent alongside your response to the request to resolve the intended media item. This allows the client to skip subsequent requests when you can resolve each parameter successfully. If your service responds with a disambiguation, confirmation, or failure, the client disregards the pre-emptive responses, and sends the subsequent intent-processing requests.

## HTTP Body

An array of intents to play media.

## Topics

### Processing a Play Media Intent

- [PlayMediaIntent](sirikitcloudmedia/playmediaintent.md)
- [PlayMediaIntentHandlingInvocation](sirikitcloudmedia/playmediaintenthandlinginvocation.md)
- [PlayMediaIntentHandlingInvocationResponse](sirikitcloudmedia/playmediaintenthandlinginvocationresponse.md)

### Resolving a Media Item

- [PlayMediaIntentHandlingResolveMediaItemsInvocationResponse](sirikitcloudmedia/playmediaintenthandlingresolvemediaitemsinvocationresponse.md)
- [PlayMediaMediaItemResolutionResult](sirikitcloudmedia/playmediamediaitemresolutionresult.md)
- [PlayMediaMediaItemUnsupportedReason](sirikitcloudmedia/playmediamediaitemunsupportedreason.md)

### Handling a Play Media Intent

- [PlayMediaIntentHandlingHandleInvocationResponse](sirikitcloudmedia/playmediaintenthandlinghandleinvocationresponse.md)
- [PlayMediaIntentResponse](sirikitcloudmedia/playmediaintentresponse.md)
- [PlayMediaIntentResponseCode](sirikitcloudmedia/playmediaintentresponsecode.md)

### Resolving the Intended Repeat Mode

- [PlayMediaIntentHandlingResolvePlaybackRepeatModeInvocationResponse](sirikitcloudmedia/playmediaintenthandlingresolveplaybackrepeatmodeinvocationresponse.md)
- [PlayMediaIntentHandlingResolvePlaybackRepeatModeInvocationResponse.Result](sirikitcloudmedia/playmediaintenthandlingresolveplaybackrepeatmodeinvocationresponse/result-data.dictionary.md)
- [PlaybackRepeatModeResolutionResult](sirikitcloudmedia/playbackrepeatmoderesolutionresult.md)
- [PlaybackRepeatMode](sirikitcloudmedia/playbackrepeatmode.md)

### Resolving the Intended Queue Location

- [PlayMediaIntentHandlingResolvePlaybackQueueLocationInvocationResponse](sirikitcloudmedia/playmediaintenthandlingresolveplaybackqueuelocationinvocationresponse.md)
- [PlaybackQueueLocationResolutionResult](sirikitcloudmedia/playbackqueuelocationresolutionresult.md)
- [PlaybackQueueLocation](sirikitcloudmedia/playbackqueuelocation.md)

### Resuming Playback

- [PlayMediaIntentHandlingResolveResumePlaybackInvocationResponse](sirikitcloudmedia/playmediaintenthandlingresolveresumeplaybackinvocationresponse.md)

### Shuffling Playback

- [PlayMediaIntentHandlingResolvePlayShuffledInvocationResponse](sirikitcloudmedia/playmediaintenthandlingresolveplayshuffledinvocationresponse.md)

## See Also

### Media Play Queues

- [Get a Media Queue](sirikitcloudmedia/playmedia-1onzj.md)
