Change Repository Item (artifact) Locator

Moves an item to a different logical folder.

URL

Copy 
https://<your-cloud>.app.perfectomobile.com/repository/api/v1/artifacts/

Method

PATCH

Header parameters

Name Description
Perfecto-Authorization

Security Token

Data parameters (body)

Parameter Description
artifactLocator

Unique artifact identifier.

Format:

{folderType}:{artifactKey}

where:

  • folderType: Defines privileges of accessibility. Possible values:

    • PRIVATE: Only the owner has access to the artifact.

    • GROUP: Only users related to the owner’s group will have access to the artifact.

    • PUBLIC: All users have access to the artifact.

  • artifactKey: Unique identifier of the artifact

    The artifactKey cannot contain backslash (\) characters. If no artifactName is provided, artifactKey cannot contain any of the following characters: /\:"*?<>|”
targetArtifactLocator The new locator for the artifact. Same format as artifactLocator.
override

Optional. Whether to override if an artifact with the sameartifactLocatorexists. Default value isfalse.
Copy 
{
"artifactLocator":"",        (Identifies artifact to change, mandatory)
"targetArtifactLocator":"",      (new locator for artifact, mandatory)
"override": ""}

Success response

Code: 200

Error response

Error code Reason
400 BAD REQUEST Request included the wrong body content
401 UNAUTHORIZED Wrong security token
404 NOT FOUND Item does not exist
500 INTERNAL_SERVER_ERROR Internal error