# App: Replace

Information note**LOCKED.**   
  
This API is extremely reliable and will not be broken unless absolutely necessary.

## Method

PUT

## Path

/qrs/app/{id}/replace?app={appid}

## Description

Replace an app, identified by `{appid}`, with the app identified by `{id}`.

If the replaced app is published, only the sheets that were originally published with the app are replaced. If the replaced app is not published, the entire app is replaced.

Information noteThe app identified by `{id}` (that is, the app that is used to replace another app) is not removed.

## Body

-

## Return value

```
{
  "privileges" : [ "privileges", "privileges" ],
  "description" : "description",
  "savedInProductVersion" : "savedInProductVersion",
  "sourceAppId" : "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "lastReloadTime" : "2000-01-23T04:56:07.000+00:00",
  "modifiedByUserName" : "modifiedByUserName",
  "stream" : {
    "privileges" : [ "privileges", "privileges" ],
    "name" : "name",
    "id" : "046b6c7f-0b8a-43b9-b35d-6489e6daee91"
  },
  "appId" : "appId",
  "id" : "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "availabilityStatus" : { },
  "targetAppId" : "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "owner" : {
    "privileges" : [ "privileges", "privileges" ],
    "userDirectory" : "userDirectory",
    "userDirectoryConnectorName" : "userDirectoryConnectorName",
    "name" : "name",
    "id" : "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "userId" : "userId"
  },
  "publishTime" : "2000-01-23T04:56:07.000+00:00",
  "migrationHash" : "migrationHash",
  "thumbnail" : "thumbnail",
  "schemaPath" : "schemaPath",
  "published" : true,
  "tags" : [ {
    "privileges" : [ "privileges", "privileges" ],
    "name" : "name",
    "id" : "046b6c7f-0b8a-43b9-b35d-6489e6daee91"
  }, 
  {
    "privileges" : [ "privileges", "privileges" ],
    "name" : "name",
    "id" : "046b6c7f-0b8a-43b9-b35d-6489e6daee91"
  } ],
  "createdDate" : "2000-01-23T04:56:07.000+00:00",
  "customProperties" : [ {
    "createdDate" : "2000-01-23T04:56:07.000+00:00",
    "modifiedByUserName" : "modifiedByUserName",
    "schemaPath" : "schemaPath",
    "modifiedDate" : "2000-01-23T04:56:07.000+00:00",
    "definition" : {
      "privileges" : [ "privileges", "privileges" ],
      "valueType" : "valueType",
      "name" : "name",
      "choiceValues" : [ "choiceValues", "choiceValues" ],
      "id" : "046b6c7f-0b8a-43b9-b35d-6489e6daee91"
    },
    "id" : "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "value" : "value"
  },
  {
    "createdDate" : "2000-01-23T04:56:07.000+00:00",
    "modifiedByUserName" : "modifiedByUserName",
    "schemaPath" : "schemaPath",
    "modifiedDate" : "2000-01-23T04:56:07.000+00:00",
    "definition" : {
      "privileges" : [ "privileges", "privileges" ],
      "valueType" : "valueType",
      "name" : "name",
      "choiceValues" : [ "choiceValues", "choiceValues" ],
      "id" : "046b6c7f-0b8a-43b9-b35d-6489e6daee91"
    },
    "id" : "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
    "value" : "value"
  } ],
  "fileSize" : 0,
  "lastDataDistribution" : "2000-01-23T04:56:07.000+00:00",
  "modifiedDate" : "2000-01-23T04:56:07.000+00:00",
  "name" : "name",
  "dynamicColor" : "dynamicColor"
}
```

## Optional parameters

-