MSM APIs (2026.04-experimental)

Download OpenAPI specification:Download

Live Copy Source Management

List all Live Copy Sources

This operation provides support for retrieving all the Live Copy Sources accessible to the current user, determined via the applied request authorization. By default this call will return a maximum of 50 items. The caller can define other limits suited to their application (see the limit query parameter), but the limit cannot be higher than 50. To ask for the next set of items pass the value of the cursor provided in the response to the cursor query parameter.

SecurityBearer
Request
query Parameters
cursor
string (Cursor) non-empty

When the number of results for a request exceeds the allowed limit, the response will include a cursor. That value can then be sent via this parameter on a subsequent request to retrieve the next set of items.

limit
integer <int32> (Limit) [ 1 .. 50 ]

For a paginated request, this parameter defines the maximum number of items to retrieve.

header Parameters
If-None-Match
string

The If-None-Match header field makes the request method conditional on a recipient cache or origin server either not having any current representation of the target resource, when the field value is "*", or having a selected representation with an entity tag that does not match any of those listed in the field value.

For more details, please head over to RFC9110.

Responses
200

List of Live Copy Sources.

304

Not Modified

401

Unauthorized

403

Forbidden

406

Unacceptable. Indicates that the target resource does not have a current representation that would be acceptable to the user agent, according to the proactive negotiation header fields received in the request.

500

The server encountered an unexpected error. Retrying the request after a certain time could help.

get/sources
Request samples 
Response samples 
application/json
{
  • "items": [
    ],
  • "cursor": "string"
}
Get a Live Copy Source Details
SecurityBearer 
Request 
path Parameters
sourceId
required
string <uuid>  (UUID) 
Id of the Live Copy Source for which the operation is performed.


 
 Example:  49af775d-0e7a-46c3-913d-00f762528373
header Parameters
If-None-Match
string
The If-None-Match header field makes the request method conditional on a recipient cache or origin server either
not having any current representation of the target resource, when the field value is "*", or having a selected
representation with an entity tag that does not match any of those listed in the field value.


For more details, please head over to RFC9110.


 
Responses 
200
Live Copy Source found


304
Not Modified


401
Unauthorized


403
Forbidden


404
Not Found


406
Unacceptable. Indicates that the target resource does not have a current representation that would be acceptable to the user agent,
according to the proactive negotiation header fields received in the request.


500
The server encountered an unexpected error. Retrying the request after a certain time could help.


get/sources/{sourceId}
Request samples 
Response samples 
application/json
{
  • "sourcePath": "string",
  • "sourceId": "49af775d-0e7a-46c3-913d-00f762528373",
  • "liveCopies": [
    ]
}
Live Copy Management
List all Live Copies
This operation provides support for retrieving all the Live Copies accessible to the current user, 
determined via the applied request authorization. By default this call will return a maximum of 50 items.
The caller can define other limits suited to their application (see the limit query parameter), 
but the limit cannot be higher than 50. To ask for the next set of items pass the value of the cursor provided 
in the response to the cursor query parameter.


SecurityBearer 
Request 
query Parameters
filterByResourceId
string <uuid>  (UUID) 
When present, results will be returned only for this Resource.


 
 Example:  filterByResourceId=49af775d-0e7a-46c3-913d-00f762528373
cursor
string (Cursor)   non-empty 
When the number of results for a request exceeds the allowed limit, the response will include a cursor.  That value can then be sent via this parameter on a subsequent request to retrieve the next set of items.


 
limit
integer <int32>  (Limit)   [ 1 .. 50 ] 
For a paginated request, this parameter defines the maximum number of items to retrieve.


 
header Parameters
If-None-Match
string
The If-None-Match header field makes the request method conditional on a recipient cache or origin server either
not having any current representation of the target resource, when the field value is "*", or having a selected
representation with an entity tag that does not match any of those listed in the field value.


For more details, please head over to RFC9110.


 
Responses 
200
List of Live Copies


304
Not Modified


400
Bad Request. The Problem Details object will provide more information about the exact cause.


401
Unauthorized


403
Forbidden


406
Unacceptable. Indicates that the target resource does not have a current representation that would be acceptable to the user agent,
according to the proactive negotiation header fields received in the request.


500
The server encountered an unexpected error. Retrying the request after a certain time could help.


get/
Request samples 
Response samples 
application/json
{
  • "items": [
    ],
  • "cursor": "string"
}
Get the Details of the Live Copy
SecurityBearer 
Request 
path Parameters
liveCopyId
required
string <uuid>  (UUID) 
Id of the Live Copy for which the operation is performed


 
 Example:  49af775d-0e7a-46c3-913d-00f762528373
header Parameters
If-None-Match
string
The If-None-Match header field makes the request method conditional on a recipient cache or origin server either
not having any current representation of the target resource, when the field value is "*", or having a selected
representation with an entity tag that does not match any of those listed in the field value.


For more details, please head over to RFC9110.


 
Responses 
200
Live Copy found


304
Not Modified


401
Unauthorized


403
Forbidden


404
Not Found


406
Unacceptable. Indicates that the target resource does not have a current representation that would be acceptable to the user agent,
according to the proactive negotiation header fields received in the request.


500
The server encountered an unexpected error. Retrying the request after a certain time could help.


get/{liveCopyId}
Request samples 
Response samples 
application/json
{
  • "sourcePath": "string",
  • "sourceId": "49af775d-0e7a-46c3-913d-00f762528373",
  • "liveCopyId": "49af775d-0e7a-46c3-913d-00f762528373",
  • "rootPath": "string",
  • "title": "string",
  • "name": "string",
  • "shallow": true,
  • "rolloutConfigs": [
    ],
  • "lastRolledOut": "2019-08-24T14:15:22Z",
  • "lastRolledOutBy": "string",
  • "inSync": true,
  • "isSuspended": true,
  • "isCancelledForChildren": true
}
Delete the Live Copy
This operation deletes a Live Copy, given the appropriate parameters. 
The ETag value required by the If-Match header must contain the value of the ETag header returned by the corresponding GET request.


SecurityBearer 
Request 
path Parameters
liveCopyId
required
string <uuid>  (UUID) 
Id of the Live Copy for which the operation is performed


 
 Example:  49af775d-0e7a-46c3-913d-00f762528373
query Parameters
softDelete
boolean
 Default:  false
When set to true, the Live Copy will be deleted without its content.


 
header Parameters
If-Match
required
string
The If-Match header field makes the request method conditional on the recipient origin server either having at least
one current representation of the target resource, when the field value is "*", or having a current representation of
the target resource that has an entity tag matching a member of the list of entity tags provided in the field value.


For more details, please head over to RFC9110.


 
Responses 
204
No Content


400
Bad Request. The Problem Details object will provide more information about the exact cause.


403
Forbidden


404
Not Found


412
Precondition Failed


428
Precondition Required


500
The server encountered an unexpected error. Retrying the request after a certain time could help.


delete/{liveCopyId}
Request samples 
Response samples 
application/problem+json
{}
Trigger a synchronize operation from a given Live Copy
This operation triggers a synchronize (rollout) operation for a specific Live Copy.


SecurityBearer 
Request 
path Parameters
liveCopyId
required
string <uuid>  (UUID) 
Id of the Live Copy for which the operation is performed


 
 Example:  49af775d-0e7a-46c3-913d-00f762528373
Request Body schema: application/json
required
object (GranularRolloutDetails) 
 
scheduledDate
string <date-time> 
A string that specifies the date when the Job should be executed. If it is missing
then the rollout will happen immediately.


 
Responses 
202
This is an asynchronous operation. Please follow the URL from the Location header to get the status of the Job that creates the Rollout Job.


400
Bad Request. The Problem Details object will provide more information about the exact cause.


401
Unauthorized


403
Forbidden


404
Not Found


406
Unacceptable. Indicates that the target resource does not have a current representation that would be acceptable to the user agent,
according to the proactive negotiation header fields received in the request.


415
Unsupported Media Type. When provided as a response to a PATCH request,
the response will provide an Accept-Patch response header to notify
the client what patch document media types are supported.


500
The server encountered an unexpected error. Retrying the request after a certain time could help.


post/{liveCopyId}/synchronize
Request samples 
application/json
{
  • "value": {
    }
}
Response samples 
application/problem+json
{}
Detach a Live Copy from its source
This operation permanently detaches a Live Copy from its source. Once detached, the content
will no longer inherit values from the source or participate in rollouts.


This action cannot be undone. The ETag value required by the If-Match header must contain
the value of the ETag header returned by the corresponding GET request for the Live Copy.


SecurityBearer 
Request 
path Parameters
liveCopyId
required
string <uuid>  (UUID) 
Id of the Live Copy for which the operation is performed


 
 Example:  49af775d-0e7a-46c3-913d-00f762528373
header Parameters
If-Match
required
string
The If-Match header field makes the request method conditional on the recipient origin server either having at least
one current representation of the target resource, when the field value is "*", or having a current representation of
the target resource that has an entity tag matching a member of the list of entity tags provided in the field value.


For more details, please head over to RFC9110.


 
Responses 
204
No Content


400
Bad Request. The Problem Details object will provide more information about the exact cause.


401
Unauthorized


403
Forbidden


404
Not Found


412
Precondition Failed


428
Precondition Required


500
The server encountered an unexpected error. Retrying the request after a certain time could help.


post/{liveCopyId}/detach
Request samples 
Response samples 
application/problem+json
{}
Suspend inheritance for a given Live Copy
This operation suspends inheritance and rollout activities for a specific Live Copy.
Suspending this Live Copy will temporarily stop inheritance and rollout activities.
Updates from its source will not be received while suspended. You can resume it at any time.


SecurityBearer 
Request 
path Parameters
liveCopyId
required
string <uuid>  (UUID) 
Id of the Live Copy for which the operation is performed


 
 Example:  49af775d-0e7a-46c3-913d-00f762528373
Responses 
204
No Content


400
Bad Request. The Problem Details object will provide more information about the exact cause.


401
Unauthorized


403
Forbidden


404
Not Found


500
The server encountered an unexpected error. Retrying the request after a certain time could help.


post/{liveCopyId}/suspend
Request samples 
Response samples 
application/problem+json
{}
Resume inheritance for a given Live Copy
This operation resumes a specific Live Copy.
Resuming this Live Copy will restore inheritance and rollout activities.
It will begin receiving updates from its source again.


SecurityBearer 
Request 
path Parameters
liveCopyId
required
string <uuid>  (UUID) 
Id of the Live Copy for which the operation is performed


 
 Example:  49af775d-0e7a-46c3-913d-00f762528373
Responses 
204
No Content


400
Bad Request. The Problem Details object will provide more information about the exact cause.


401
Unauthorized


403
Forbidden


404
Not Found


500
The server encountered an unexpected error. Retrying the request after a certain time could help.


post/{liveCopyId}/resume
Request samples 
Response samples 
application/problem+json
{}
Reset inheritance for a given Live Copy
This operation resets a Live Copy, restoring full inheritance from its source.
It is equivalent to a Resume + Rollout.
All field values will be replaced with those from the source, including any fields
where inheritance was previously overridden.


The ETag value required by the If-Match header must contain the value of the
ETag header returned by the corresponding GET request for the Live Copy.


SecurityBearer 
Request 
path Parameters
liveCopyId
required
string <uuid>  (UUID) 
Id of the Live Copy for which the operation is performed


 
 Example:  49af775d-0e7a-46c3-913d-00f762528373
header Parameters
If-Match
required
string
The If-Match header field makes the request method conditional on the recipient origin server either having at least
one current representation of the target resource, when the field value is "*", or having a current representation of
the target resource that has an entity tag matching a member of the list of entity tags provided in the field value.


For more details, please head over to RFC9110.


 
Request Body schema: application/json
optional
scheduledDate
string <date-time> 
A string that specifies the date when the Job should be executed. If it is missing
then the rollout will happen immediately.


 
Responses 
202
This is an asynchronous operation. Please follow the URL from the Location header to get the status of the Job that executes the Rollout, which is the second step of the Reset operation.


400
Bad Request. The Problem Details object will provide more information about the exact cause.


401
Unauthorized


403
Forbidden


404
Not Found


412
Precondition Failed


428
Precondition Required


500
The server encountered an unexpected error. Retrying the request after a certain time could help.


post/{liveCopyId}/reset
Request samples 
application/json
{
  • "value": {
    }
}
Response samples 
application/problem+json
{}
List the broken inheritance elements for this Live Copy
This operation provides support for retrieving all the elements of this Live Copy accessible to the current
user that have a broken inheritance relationship. Depending on the liveCopyId, the response will be
either a combination of Resources and paths (in case the liveCopyId parameter indicates a Page Live
Copy) or a combination of variation and fields (in case the liveCopyId parameter indicates a Content
Fragment Live Copy).


By default this call will return a maximum of 50 items. The caller can define other limits suited to their
application (see the limit query parameter), but the limit cannot be higher than 50. To ask for the next
set of items pass the value of the cursor provided in the response to the cursor query parameter.


SecurityBearer 
Request 
path Parameters
liveCopyId
required
string <uuid>  (UUID) 
Id of the Live Copy for which the operation is performed


 
 Example:  49af775d-0e7a-46c3-913d-00f762528373
query Parameters
filterByResourceId
string <uuid>  (UUID) 
When present, results will be returned only for this Resource.


 
 Example:  filterByResourceId=49af775d-0e7a-46c3-913d-00f762528373
cursor
string (Cursor)   non-empty 
When the number of results for a request exceeds the allowed limit, the response will include a cursor.  That value can then be sent via this parameter on a subsequent request to retrieve the next set of items.


 
limit
integer <int32>  (Limit)   [ 1 .. 50 ] 
For a paginated request, this parameter defines the maximum number of items to retrieve.


 
header Parameters
If-None-Match
string
The If-None-Match header field makes the request method conditional on a recipient cache or origin server either
not having any current representation of the target resource, when the field value is "*", or having a selected
representation with an entity tag that does not match any of those listed in the field value.


For more details, please head over to RFC9110.


 
Responses 
200
List of broken inheritance elements


304
Not Modified


400
Bad Request. The Problem Details object will provide more information about the exact cause.


401
Unauthorized


403
Forbidden


406
Unacceptable. Indicates that the target resource does not have a current representation that would be acceptable to the user agent,
according to the proactive negotiation header fields received in the request.


500
The server encountered an unexpected error. Retrying the request after a certain time could help.


get/{liveCopyId}/brokenInheritanceElements
Request samples 
Response samples 
application/json
{
  • "items": [
    ],
  • "cursor": "string"
}
Trigger a modify inheritance operation for a given Live Copy
This operation triggers a modify inheritance operation for a specific Live Copy. It can be used to break or restore inheritance for a given resource within the specified live copy.


SecurityBearer 
Request 
path Parameters
liveCopyId
required
string <uuid>  (UUID) 
Id of the Live Copy for which the operation is performed


 
 Example:  49af775d-0e7a-46c3-913d-00f762528373
header Parameters
If-Match
required
string
The If-Match header field makes the request method conditional on the recipient origin server either having at least
one current representation of the target resource, when the field value is "*", or having a current representation of
the target resource that has an entity tag matching a member of the list of entity tags provided in the field value.


For more details, please head over to RFC9110.


 
Request Body schema: application/json
required
required
Array of objects (InheritanceElement) 
List of children Sub-Resources or Content Fragments of the current Live Copy (liveCopyId).


 
Responses 
200
The Updated List of broken inheritance elements


400
Bad Request. The Problem Details object will provide more information about the exact cause.


401
Unauthorized


403
Forbidden


406
Unacceptable. Indicates that the target resource does not have a current representation that would be acceptable to the user agent,
according to the proactive negotiation header fields received in the request.


412
Precondition Failed


415
Unsupported Media Type. When provided as a response to a PATCH request,
the response will provide an Accept-Patch response header to notify
the client what patch document media types are supported.


500
The server encountered an unexpected error. Retrying the request after a certain time could help.


put/{liveCopyId}/brokenInheritanceElements
Request samples 
application/json
{
  • "items": [
    ]
}
Response samples 
application/json
{
  • "items": [
    ]
}
Create a Live Copy from a given Live Copy Source
This operation creates a Live Copy, starting from a Live Copy Source, given the appropriate parameters.


SecurityBearer 
Request 
path Parameters
sourceId
required
string <uuid>  (UUID) 
Id of the Live Copy Source for which the operation is performed.


 
 Example:  49af775d-0e7a-46c3-913d-00f762528373
Request Body schema: application/json
required
title
required
string  non-empty 
The title of the Live Copy, as used for display purposes.


 
name
string  non-empty 
Optional parameter that represents the name used when storing the Live Copy. When missing, the value will be derived by the server from the title value.


 
shallow
boolean
 Default:  false
Specifies whether the Live Copy is deep or shallow.
A deep Live Copy includes all the child pages of the source page.
A shallow Live Copy includes only the source page.


 
destinationPath
required
string  non-empty ^(?:(?!\*|\[|\]|\||\\|\|).)*$
A string that specifies the destination of the Live Copy.


 
rolloutConfigs
Array of strings (Path) 
An array of strings that can contain various existent rollout configs defined in AEM.
When not provided the default rollout config will be used.


 
scheduledDate
string <date-time> 
A string that specifies the date when the job should be executed.


 
Responses 
202
This is an asynchronous operation. Please follow the URL from the Location header to get the status of the Job that creates the Live Copy.


400
Bad Request. The Problem Details object will provide more information about the exact cause.


401
Unauthorized


403
Forbidden


404
Not Found


406
Unacceptable. Indicates that the target resource does not have a current representation that would be acceptable to the user agent,
according to the proactive negotiation header fields received in the request.


415
Unsupported Media Type. When provided as a response to a PATCH request,
the response will provide an Accept-Patch response header to notify
the client what patch document media types are supported.


500
The server encountered an unexpected error. Retrying the request after a certain time could help.


post/sources/{sourceId}
Request samples 
application/json
{
  • "value": {
    }
}
Response samples 
application/problem+json
{}
Create multiple Live Copies from a given Live Copy Source
This operation creates multiple Live Copies to different destinations, starting from a Live Copy Source, given the appropriate parameters. Returns a 200 OK response with job IDs for tracking the individual Live Copy creation jobs.


SecurityBearer 
Request 
path Parameters
sourceId
required
string <uuid>  (UUID) 
Id of the Live Copy Source for which the operation is performed.


 
 Example:  49af775d-0e7a-46c3-913d-00f762528373
Request Body schema: application/json
required
title
required
string  non-empty 
The title of the Live Copies, as used for display purposes.


 
name
string  non-empty 
Optional parameter that represents the name used when storing the Live Copies. When missing, the value will be derived by the server from the title value.


 
shallow
boolean
 Default:  false
Specifies whether the Live Copies are deep or shallow.
A deep Live Copy includes all the child pages of the source page.
A shallow Live Copy includes only the source page.


 
destinationPaths
required
Array of strings (Path)   non-empty 
An array of strings that specifies multiple destinations for multiple Live Copies.


 
rolloutConfigs
Array of strings (Path) 
An array of strings that can contain various existent rollout configs defined in AEM.
When not provided the default rollout config will be used.


 
scheduledDate
string <date-time> 
A string that specifies the date when the jobs should be executed.


 
Responses 
200
Multiple Live Copy creation jobs have been initiated successfully


400
Bad Request. The Problem Details object will provide more information about the exact cause.


401
Unauthorized


403
Forbidden


404
Not Found


406
Unacceptable. Indicates that the target resource does not have a current representation that would be acceptable to the user agent,
according to the proactive negotiation header fields received in the request.


415
Unsupported Media Type. When provided as a response to a PATCH request,
the response will provide an Accept-Patch response header to notify
the client what patch document media types are supported.


500
The server encountered an unexpected error. Retrying the request after a certain time could help.


post/sources/{sourceId}/createLiveCopies
Request samples 
application/json
{
  • "value": {
    }
}
Response samples 
application/json
{
  • "value": {
    }
}
Trigger a rollout operation from a given Live Copy Source
This operation triggers a rollout operation, starting from a Live Copy Source, given the appropriate parameters.


SecurityBearer 
Request 
path Parameters
sourceId
required
string <uuid>  (UUID) 
Id of the Live Copy Source for which the operation is performed.


 
 Example:  49af775d-0e7a-46c3-913d-00f762528373
Request Body schema: application/json
required
Array of objects (RolloutLiveCopyDetails) 
When present, this will execute the rollout only to the provided Live Copies;
otherwise the rollout will execute to all Live Copies.


 
scheduledDate
string <date-time>   non-empty 
A string that specifies the date when the Job should be executed. If it is missing
then the rollout will happen immediately.


 
shallow
boolean
 Default:  true
When true (default), only the direct source is rolled out.
When false, the full graph of referenced resources (e.g. child content
fragments) is included in the rollout.


 
publishOnRollout
boolean
 Default:  false
When true, the rolled-out targets are published (activated) immediately
after the rollout completes. Defaults to false.


 
Responses 
202
This is an asynchronous operation. Please follow the URL from the Location header to get the status of the Job that creates the Rollout Job.


400
Bad Request. The Problem Details object will provide more information about the exact cause.


401
Unauthorized


403
Forbidden


404
Not Found


406
Unacceptable. Indicates that the target resource does not have a current representation that would be acceptable to the user agent,
according to the proactive negotiation header fields received in the request.


415
Unsupported Media Type. When provided as a response to a PATCH request,
the response will provide an Accept-Patch response header to notify
the client what patch document media types are supported.


500
The server encountered an unexpected error. Retrying the request after a certain time could help.


post/sources/{sourceId}/rollout
Request samples 
application/json
{
  • "value": {
    }
}
Response samples 
application/problem+json
{}
Get MSM status for a resource
This operation retrieves the MSM (Multi-Site Manager) status for a given resource.
It indicates whether the resource is a blueprint (Live Copy Source), a Live Copy, both, or neither.


A 200 response with isBlueprint: false and isLiveCopy: false indicates that the resource
exists but has no MSM relationships.


SecurityBearer 
Request 
path Parameters
resourceId
required
string <uuid>  (UUID) 
The unique identifier of the resource for which the MSM status is requested.


Supported resources: Content Fragment. Additional resources will be supported in the future.


 
 Example:  49af775d-0e7a-46c3-913d-00f762528373
header Parameters
If-None-Match
string
The If-None-Match header field makes the request method conditional on a recipient cache or origin server either
not having any current representation of the target resource, when the field value is "*", or having a selected
representation with an entity tag that does not match any of those listed in the field value.


For more details, please head over to RFC9110.


 
Responses 
200
MSM status retrieved successfully. The response indicates whether the resource is a blueprint,
a live copy, both, or neither.


304
Not Modified


400
Bad Request. The Problem Details object will provide more information about the exact cause.


401
Unauthorized


403
Forbidden


404
Not Found


406
Unacceptable. Indicates that the target resource does not have a current representation that would be acceptable to the user agent,
according to the proactive negotiation header fields received in the request.


500
The server encountered an unexpected error. Retrying the request after a certain time could help.


get/resources/{resourceId}/status
Request samples 
Response samples 
application/json
{
  • "isBlueprint": true,
  • "isLiveCopy": false
}
Jobs Status
Get Job status
Get information about the processing of the Job


SecurityBearer 
Request 
path Parameters
jobId
required
string
The id of the Job.


 
Responses 
200
Job is processing.


303
Job completed.


401
Unauthorized


403
Forbidden


404
Not Found


406
Unacceptable. Indicates that the target resource does not have a current representation that would be acceptable to the user agent,
according to the proactive negotiation header fields received in the request.


415
Unsupported Media Type. When provided as a response to a PATCH request,
the response will provide an Accept-Patch response header to notify
the client what patch document media types are supported.


500
The server encountered an unexpected error. Retrying the request after a certain time could help.


get/jobs/{jobId}/status
Request samples 
Response samples 
application/json
{
  • "state": "ACTIVE"
}
Get the result of a processed job
SecurityBearer 
Request 
path Parameters
jobId
required
string
The id of the job.


 
Responses 
200
Job completed.


400
Bad Request. The Problem Details object will provide more information about the exact cause.


401
Unauthorized


403
Forbidden


404
Not Found


406
Unacceptable. Indicates that the target resource does not have a current representation that would be acceptable to the user agent,
according to the proactive negotiation header fields received in the request.


415
Unsupported Media Type. When provided as a response to a PATCH request,
the response will provide an Accept-Patch response header to notify
the client what patch document media types are supported.


500
The server encountered an unexpected error. Retrying the request after a certain time could help.


get/jobs/{jobId}/result
Request samples 
Response samples 
{
  • "operation": "aem.msm.source.rollout",
  • "status": 500,
  • "description": "The job encountered an error during processing",
  • "data": {
    },
  • "errors": [
    ]
}