<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "SiriKitCloudMedia",
  "identifier" : "/documentation/SiriKitCloudMedia/addMedia",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "SiriKit Cloud Media"
    ],
    "preciseIdentifier" : "rest:sirikit_media_api:post:intent-addMedia"
  },
  "title" : "Process an Add Media Intent"
}
-->

# Process an Add Media Intent

Add media items to the user’s library or to a playlist.

## Discussion

Processing a request to add media items to the user’s library or to a playlist requires a few steps: resolving the intended media item, resolving the intended destination library or playlist, confirming the intent, and handling the intent.

You can often improve the overall response time to the user’s request by providing multiple responses to the client’s first request. Include an [`AddMediaIntentHandlingInvocationResponse`](/documentation/SiriKitCloudMedia/AddMediaIntentHandlingInvocationResponse) for each of the subsequent steps in your response to the first request of a session. 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.

## Topics

### Processing an Add Media Intent

[`object AddMediaIntent`](/documentation/SiriKitCloudMedia/AddMediaIntent)

An object that describes the user’s request to add media items to their library or to a specific playlist.

[`object AddMediaIntentHandlingInvocation`](/documentation/SiriKitCloudMedia/AddMediaIntentHandlingInvocation)

A request to process an add media intent.

[`* AddMediaIntentHandlingInvocationResponse`](/documentation/SiriKitCloudMedia/AddMediaIntentHandlingInvocationResponse)

The service’s response to a request to process an add media intent.

### Identifying a Media Item

[`object AddMediaIntentHandlingResolveMediaItemsInvocationResponse`](/documentation/SiriKitCloudMedia/AddMediaIntentHandlingResolveMediaItemsInvocationResponse)

Your service’s response to a request to resolve media items in an update media affinity intent.

[`object AddMediaMediaItemResolutionResult`](/documentation/SiriKitCloudMedia/AddMediaMediaItemResolutionResult)

A media item that matches an add media intent, or information about why your service can’t provide a media item.

### Identifying a Library or Playlist

[`object AddMediaIntentHandlingResolveMediaDestinationInvocationResponse`](/documentation/SiriKitCloudMedia/AddMediaIntentHandlingResolveMediaDestinationInvocationResponse)

Your service’s response to a request to resolve media items in an add media intent.

[`object AddMediaMediaDestinationResolutionResult`](/documentation/SiriKitCloudMedia/AddMediaMediaDestinationResolutionResult)

The user’s library or a specified playlist, or information about why your service can’t use the requested destination.

### Confirming and Handling an Add Media Intent

[`object AddMediaIntentResponse`](/documentation/SiriKitCloudMedia/AddMediaIntentResponse)

A structure that contains a response code indicating your service’s progress in handling an add media intent.

[`string AddMediaIntentResponseCode`](/documentation/SiriKitCloudMedia/AddMediaIntentResponseCode)

Codes your service can return when confirming or handling an add media intent.

[`object AddMediaIntentHandlingConfirmInvocationResponse`](/documentation/SiriKitCloudMedia/AddMediaIntentHandlingConfirmInvocationResponse)

The service’s response to a request to confirm an add media intent.

[`object AddMediaIntentHandlingHandleInvocationResponse`](/documentation/SiriKitCloudMedia/AddMediaIntentHandlingHandleInvocationResponse)

Your service’s response to a request to handle a fully resolved add media intent.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)