Restore Assets From Trash
post
/mobile/tools/1.0/assets/untrashing
Restores requested assets from trash.
Request
Supported Media Types
- application/json
Header Parameters
-
If-Match(optional): string
The request completes successfully only if the ETag of the corresponding asset matches the value of this HTTP request header. To force overwrite, pass the value `*`.
Asset trashing, untrashing, or purging request metadata.
Root Schema : deleteRequest
Type:
object
Asset trashing, untrashing, or purging request metadata.
Show Source
-
actionComment(optional):
string
-
dependencies(optional):
array deleteDependenciesArray
Minimum Number of Items:
0
An array of assets to be trashed, untrashed, or purged with their direct and reverse (upstream) dependencies. -
format(optional):
Allowed Values:
[ "short", "graph", "forced" ]
Nested Schema : deleteDependenciesArray
Type:
array
Minimum Number of Items:
0
An array of assets to be trashed, untrashed, or purged with their direct and reverse (upstream) dependencies.
Show Source
-
Array of:
object deleteDependencies
Asset with its dependencies for trashing, untrashing, and purging operations.
Nested Schema : deleteDependencies
Type:
object
Asset with its dependencies for trashing, untrashing, and purging operations.
Show Source
-
asset:
object deleteAsset
The asset representation for delete-dependency requests and responses. For a request body, you must include the asset ID and, optionally, the ETag. No other attributes are necessary. The response body contains the generic asset details.
-
dependencies(optional):
array dependencies
Minimum Number of Items:
0
Artifacts that this asset depends on. Also referred to as downstream dependencies. -
reverseDependencies(optional):
array reverseDependencies
Minimum Number of Items:
0
Artifacts that depend on this artifact. Also referred to as upstream dependencies.
Nested Schema : deleteAsset
Type:
object
The asset representation for delete-dependency requests and responses. For a request body, you must include the asset ID and, optionally, the ETag. No other attributes are necessary. The response body contains the generic asset details.
Match All
Show Source
-
object assetGet
The asset representation for GET requests.
-
object deleteAsset-allOf[1]
Nested Schema : dependencies
Type:
array
Minimum Number of Items:
0
Artifacts that this asset depends on. Also referred to as downstream dependencies.
Show Source
-
Array of:
object deleteAsset
The asset representation for delete-dependency requests and responses. For a request body, you must include the asset ID and, optionally, the ETag. No other attributes are necessary. The response body contains the generic asset details.
Nested Schema : reverseDependencies
Type:
array
Minimum Number of Items:
0
Artifacts that depend on this artifact. Also referred to as upstream dependencies.
Show Source
-
Array of:
object deleteAsset
The asset representation for delete-dependency requests and responses. For a request body, you must include the asset ID and, optionally, the ETag. No other attributes are necessary. The response body contains the generic asset details.
Nested Schema : assetGet
Type:
object
The asset representation for GET requests.
Match All
Show Source
-
object assetUpdate
The asset representation for PUT requests.
-
object assetIdEtag
The asset ID and entity tag (ETag) values.
-
object trash
Indicator of whether the asset is in the trash.
-
object assetGet-allOf[3]
Nested Schema : deleteAsset-allOf[1]
Type:
Show Source
object
-
errors(optional):
array deleteErrorArray
Minimum Number of Items:
0
An array of asset delete-dependency errors.
Nested Schema : assetUpdate
Type:
object
The asset representation for PUT requests.
Show Source
-
actionComment(optional):
string
-
desc(optional):
string
Maximum Length:
100
-
max(optional):
boolean
Default Value:
false
-
name:
string
Maximum Length:
100
Pattern:^[a-zA-Z][a-zA-Z0-9_]*$
-
namespace(optional):
string
Applicable to APIs and implementations only. This value is null for all other asset types.
-
title(optional):
string
Maximum Length:
255
-
version(optional):
string
Maximum Length:
100
Pattern:^[a-zA-Z0-9][\w.]*$
Asset version.
Nested Schema : assetIdEtag
Type:
object
The asset ID and entity tag (ETag) values.
Show Source
-
etag(optional):
string
The asset entity tag (ETag) value, which you can use to detect concurrent modification.
-
id:
string
Nested Schema : assetGet-allOf[3]
Type:
Show Source
object
-
createdOn(optional):
string
-
deletedBy(optional):
string
-
deletedOn(optional):
string
-
links(optional):
array entityLinksArray
Minimum Number of Items:
0
An array of links for an entity's metadata. -
modifiedBy(optional):
string
-
modifiedOn(optional):
string
-
published(optional):
boolean
An asset draft or published status representation.
Nested Schema : entityLinksArray
Type:
array
Minimum Number of Items:
0
An array of links for an entity's metadata.
Show Source
-
Array of:
object items
Link to the entity's metadata.
Nested Schema : items
Type:
object
Link to the entity's metadata.
Show Source
-
href:
string
Link value.
-
rel:
Allowed Values:
[ "self", "canonical" ]
Link type.
Nested Schema : deleteErrorArray
Type:
array
Minimum Number of Items:
0
An array of asset delete-dependency errors.
Show Source
-
Array of:
object deleteError
The asset delete dependencies error metadata.
Nested Schema : deleteError
Type:
object
The asset delete dependencies error metadata.
Show Source
-
detail(optional):
string
-
errorCode:
string
-
params(optional):
array stringArray
Minimum Number of Items:
0
An array of string values.
Nested Schema : stringArray
Type:
array
Minimum Number of Items:
0
An array of string values.
Show Source
Response
Supported Media Types
- application/json
204 Response
Assets were restored. No content was returned in this response.
400 Response
The operation failed based on the dependencies state that was passed in the request.
Root Schema : error
Type:
Show Source
object
-
detail:
string
Message that provides the error details.
-
o:ecid:
string
Execution context ID, which is a unique identifier to correlate events or requests that are associated with the same transaction across several components.
-
o:errorCode:
string
The service's error code.
-
o:errorDetails(optional):
object errorDetails
-
o:errorPath:
string
The relative point in the API path where the error occurred.
-
status:
integer(int64)
HTTP status code. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html for more details.
-
title:
string
Summary of the problem.
-
type:
string
The URI to the link that provides details about the HTTP status code.
Nested Schema : errorDetails
Type:
Show Source
object
-
detail:
string
-
o:errorDetails(optional):
object errorDetails
-
title:
string
Summary of the problem.
-
type:
string
The URI to the link that provides details about the HTTP status code.
409 Response
Assets with the same name and version as requested already exist.
Root Schema : error
Type:
Show Source
object
-
detail:
string
Message that provides the error details.
-
o:ecid:
string
Execution context ID, which is a unique identifier to correlate events or requests that are associated with the same transaction across several components.
-
o:errorCode:
string
The service's error code.
-
o:errorDetails(optional):
object errorDetails
-
o:errorPath:
string
The relative point in the API path where the error occurred.
-
status:
integer(int64)
HTTP status code. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html for more details.
-
title:
string
Summary of the problem.
-
type:
string
The URI to the link that provides details about the HTTP status code.
Nested Schema : errorDetails
Type:
Show Source
object
-
detail:
string
-
o:errorDetails(optional):
object errorDetails
-
title:
string
Summary of the problem.
-
type:
string
The URI to the link that provides details about the HTTP status code.
412 Response
The operation failed based on the `If-Match` condition. Typically, this is the result of concurrent modification detection. It also can be the result of improper values specified in the request headers.
Root Schema : error
Type:
Show Source
object
-
detail:
string
Message that provides the error details.
-
o:ecid:
string
Execution context ID, which is a unique identifier to correlate events or requests that are associated with the same transaction across several components.
-
o:errorCode:
string
The service's error code.
-
o:errorDetails(optional):
object errorDetails
-
o:errorPath:
string
The relative point in the API path where the error occurred.
-
status:
integer(int64)
HTTP status code. See http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html for more details.
-
title:
string
Summary of the problem.
-
type:
string
The URI to the link that provides details about the HTTP status code.
Nested Schema : errorDetails
Type:
Show Source
object
-
detail:
string
-
o:errorDetails(optional):
object errorDetails
-
title:
string
Summary of the problem.
-
type:
string
The URI to the link that provides details about the HTTP status code.