---
title: Get a Media Queue
framework: SiriKit Cloud Media
role: symbol
role_heading: Web Service Endpoint
platforms: [sirikit cloud media 1.0.2+]
path: sirikitcloudmedia/playmedia-1onzj
---

# Get a Media Queue

Provide a playback queue from a successfully processed play media intent.

## URL

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

## Header Parameters

Accept-Language: The client’s current user interface language. Respond with localized content for this language, if available. 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. 204 No Content: No more content exists for the requested queue. 401 Unauthorized: The request requires authorization. The client may attempt to reauthorize and then retry. 410 Gone: The request’s UserActivity is permanently expired and invalid for requesting a queue.

## Discussion

Discussion There isn’t a default path for this endpoint. Specify the URL for this endpoint in your ExtensionConfig.Media.Queues.PlayMedia object.

## HTTP Body

A UserActivity and constraints for the queue your service provides.

## Topics

### Receiving a Queue Request

- [PlayMediaRequest](sirikitcloudmedia/playmediarequest.md)

### Creating or Updating a Playback Queue

- [Queue](sirikitcloudmedia/queue.md)
- [QueueIdentifier](sirikitcloudmedia/queueidentifier.md)
- [QueueInsertPointer](sirikitcloudmedia/queueinsertpointer.md)
- [QueuePlayPointer](sirikitcloudmedia/queueplaypointer.md)

### Providing Queue Items

- [Content](sirikitcloudmedia/content.md)
- [ContentIdentifier](sirikitcloudmedia/contentidentifier.md)
- [ContentAttributes](sirikitcloudmedia/contentattributes.md)

### Customizing Playback Controls

- [QueueControlMapping](sirikitcloudmedia/queuecontrolmapping.md)
- [PlayMediaControl](sirikitcloudmedia/playmediacontrol.md)
- [PlayMediaControlScheme](sirikitcloudmedia/playmediacontrolscheme.md)
- [PlayMediaControlCommandSet](sirikitcloudmedia/playmediacontrolcommandset.md)

## See Also

### Media Play Queues

- [Process a Play Media Intent](sirikitcloudmedia/playmedia-1g2o9.md)
