Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Personal apps #5203

Merged
merged 30 commits into from Jul 25, 2019
Merged
Changes from all commits
Commits
Show all changes
30 commits
Select commit Hold shift + click to select a range
b5265ee
base changes
clearab Jul 22, 2019
bbd9756
toc and v1 changes
clearab Jul 22, 2019
457e36d
Update user.md
clearab Jul 22, 2019
e668bf4
Update user.md
clearab Jul 22, 2019
bac8722
Updated action name.
Lauragra Jul 23, 2019
6906106
Edit.
Lauragra Jul 23, 2019
0402ec8
Edit.
Lauragra Jul 23, 2019
28b9e18
Removed extra /, reorganized Examples.
Lauragra Jul 23, 2019
13b9cad
Edit.
Lauragra Jul 23, 2019
2f30a7b
Edit.
Lauragra Jul 23, 2019
99acbe5
Edits.
Lauragra Jul 23, 2019
919e318
Edit.
Lauragra Jul 23, 2019
a49ef2d
testing API doctor changes
clearab Jul 23, 2019
9be34af
more api doctor test
clearab Jul 23, 2019
c44c15a
api doctor tests
clearab Jul 23, 2019
4335376
api doctor is amazing
clearab Jul 23, 2019
f4b5c4b
API doctor fixes
clearab Jul 23, 2019
fbfa27d
toc and changelog updates
clearab Jul 23, 2019
7ca0eba
changelog
clearab Jul 23, 2019
0a6042f
Fix Examples section.
Lauragra Jul 24, 2019
21f431c
Tried enabling API Doctor properly.
angelgolfer-ms Jul 24, 2019
dfa2d07
API Doctor for other ex for teamsappinstallation.
angelgolfer-ms Jul 24, 2019
dd4c299
Update teamsappinstallation.md
clearab Jul 24, 2019
66b847d
Update teamsappinstallation.md
clearab Jul 24, 2019
3f7629a
Merge branch 'master' into ac-proactive-messaging
clearab Jul 24, 2019
c5ae7ac
API Doctor for new ex, fixed changelog links.
angelgolfer-ms Jul 25, 2019
b5ee2d1
Merge branch 'ac-proactive-messaging' into angelgolfer-ms-ac-pro-5203
angelgolfer-ms Jul 25, 2019
aff9622
TOC labels correspond methods table & topic titles
angelgolfer-ms Jul 25, 2019
ed6ac43
Merge branch 'angelgolfer-ms-ac-pro-5203' of https://github.com/micro…
angelgolfer-ms Jul 25, 2019
7add05e
Merge pull request #5271 from microsoftgraph/angelgolfer-ms-ac-pro-5203
angelgolfer-ms Jul 25, 2019
File filter...
Filter file types
Jump to…
Jump to file
Failed to load files.

Always

Just for now

@@ -1,7 +1,8 @@
---
title: "Add app to team"
description: "Installs an app to the specified team."
author: "nkramer"
author: "clearab"
doc_type: "apiPageType"
localization_priority: Normal
ms.prod: "microsoft-teams"
---
@@ -13,6 +14,7 @@ ms.prod: "microsoft-teams"
Installs an [app](../resources/teamsapp.md) to the specified [team](../resources/team.md).

## Permissions

One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

|Permission type | Permissions (from least to most privileged) |
@@ -28,61 +30,60 @@ POST /teams/{id}/installedApps
```

## Request headers

| Header | Value |
|:---------------|:--------|
| Authorization | Bearer {token}. Required. |

## Request body

| Property | Type |Description|
| Property | Type |Description|
|:---------------|:--------|:----------|
|teamsApp|String|The id of the app to add.|


## Response

If successful, this method returns a `200 OK` response code.
If successful, this method returns a `200 OK` response code. It does not return anything in the response body.

## Example
#### Request

### Request

The following is an example of the request.
<!-- {
"blockType": "ignored",
"name": "get_team"
"blockType": "request",
"name": "add_teamsApp"
}-->
```http
POST https://graph.microsoft.com/beta/teams/{id}/installedApps
POST /teams/87654321-0abc-zqf0-321456789q/installedApps
Content-type: application/json
{
"teamsApp@odata.bind":"https://graph.microsoft.com/beta/appCatalogs/teamsApps/12345678-9abc-def0-123456789a"
}
```
#### Response
The following is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

### Response

The following is an example of the response.

<!-- {
"blockType": "ignored",
"truncated": true,
"@odata.type": "microsoft.graph.team"
"blockType": "response",
"truncated": true
} -->
```http
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 401
{
}
```

<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
2015-10-25 14:57:30 UTC -->
<!--
{
"type": "#page.annotation",
"description": "Get team",
"description": "Add teamsApp",
"keywords": "",
"section": "documentation",
"tocPath": "",
"suppressions": []
}
-->

## See also

@@ -1,18 +1,20 @@
---
title: "Delete app from team"
title: "Remove app from team"
description: "Uninstalls an app from the specified team."
author: "nkramer"
author: "clearab"
doc_type: "apiPageType"
localization_priority: Normal
ms.prod: "microsoft-teams"
---

# Delete app from team
# Remove app from team

[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]

Uninstalls an [app](../resources/teamsappinstallation.md) from the specified [team](../resources/team.md).

## Permissions

One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).

|Permission type | Permissions (from least to most privileged) |
@@ -28,33 +30,40 @@ DELETE /teams/{id}/installedApps/{id}
```

## Request headers

| Header | Value |
|:---------------|:--------|
| Authorization | Bearer {token}. Required. |

## Request body

Do not supply a request body for this method.

## Response

If successful, this method returns `204 No Content` response code. It does not return anything in the response body.

## Example
#### Request

### Request

The following is an example of the request.
<!-- {
"blockType": "ignored",
"name": "get_team"
"blockType": "request",
"name": "uninstall_teamsapp"
}-->
```http
DELETE https://graph.microsoft.com/beta/teams/{id}/installedApps/{id}
```
#### Response
The following is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

### Response

The following is an example of the response.

<!-- {
"blockType": "ignored",
"truncated": true,
"@odata.type": "microsoft.graph.team"
"blockType": "response",
"name": "uninstall_teamsapp",
"truncated": true
} -->
```http
HTTP/1.1 204 No Content
@@ -1,7 +1,8 @@
---
title: "List apps in team"
description: "Retrieve the list of apps installed in the specified team."
author: "nkramer"
author: "clearab"
doc_type: "apiPageType"
localization_priority: Normal
ms.prod: "microsoft-teams"
---
@@ -46,11 +47,13 @@ Do not supply a request body for this method.

## Response

If successful, this method returns a `200 OK` response code and collection of [teamsApp](../resources/teamsapp.md) objects in the response body.
If successful, this method returns a `200 OK` response code and collection of [teamsAppInstallation](../resources/teamsappinstallation.md) objects in the response body.

## Example
## Examples

### Request
### Example 1: List installed apps

#### Request

The following is an example of the request.

@@ -59,10 +62,10 @@ The following is an example of the request.
"blockType": "request",
"name": "get_installed_teams_apps"
}-->

```http
GET https://graph.microsoft.com/beta/teams/{id}/installedApps
```

# [C#](#tab/csharp)
[!INCLUDE [sample-code](../includes/snippets/csharp/get-installed-teams-apps-csharp-snippets.md)]
[!INCLUDE [sdk-documentation](../includes/snippets/snippets-sdk-documentation-link.md)]
@@ -81,22 +84,21 @@ GET https://graph.microsoft.com/beta/teams/{id}/installedApps

---


### Response
#### Response

The following is an example of the response.
>**Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
<!-- {
"blockType": "response",
"name": "get_installed_teams_apps",
"truncated": true,
"@odata.type": "microsoft.graph.directoryObject",
"@odata.type": "microsoft.graph.teamsAppInstallation",
"isCollection": true
} -->
```http
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 55
{
"value": [
@@ -107,9 +109,9 @@ Content-length: 55
}
```

## Example -- getting the names of the installed apps
### Example 2: Get the names and other details of installed apps

### Request
#### Request

The following is an example of the request.

@@ -141,22 +143,22 @@ GET https://graph.microsoft.com/beta/teams/{id}/installedApps?$expand=teamsAppDe
---


### Response
#### Response

The following is an example of the response.

>**Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
<!-- {
"blockType": "response",
"name": "get_installed_teams_apps_expand",
"truncated": true,
"@odata.type": "microsoft.graph.directoryObject",
"@odata.type": "microsoft.graph.teamsAppInstallation",
"isCollection": true
} -->
```http
HTTP/1.1 200 OK
Content-type: application/json
Content-length: 55
{
"value": [
@@ -1,7 +1,8 @@
---
title: "Upgrade an app in a team"
description: "Upgrades an app installation in a team"
author: "nkramer"
author: "clearab"
doc_type: "apiPageType"
localization_priority: Normal
ms.prod: "microsoft-teams"
---
@@ -10,8 +11,7 @@ ms.prod: "microsoft-teams"

[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]

Upgrades an [app installation](../resources/teamsappinstallation.md) in a [team](../resources/team.md)
to the latest version of the app.
Upgrades an [app installation](../resources/teamsappinstallation.md) in a [team](../resources/team.md) to the latest version of the app.

## Permissions

@@ -30,11 +30,13 @@ POST /teams/{id}/installedApps/{id}/upgrade
```

## Request headers

| Header | Value |
|:---------------|:--------|
| Authorization | Bearer {token}. Required. |

## Request body

Do not supply a request body for this method.

## Response
@@ -43,24 +45,26 @@ If successful, this method returns `204 No Content` response code. It does not r

## Example

#### Request
### Request

The following is an example of the request.
<!-- {
"blockType": "ignored",
"name": "get_team"
"blockType": "request",
"name": "upgrade_teamsapp"
}-->

```http
POST /teams/{id}/installedApps/{id}/upgrade
```
#### Response

### Response

The following is an example of the response.

>**Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
<!-- {
"blockType": "ignored",
"truncated": true,
"@odata.type": "microsoft.graph.team"
"blockType": "response",
"name": "upgrade_teamsapp",
"truncated": true
} -->
```http
HTTP/1.1 204 No Content
ProTip! Use n and p to navigate between commits in a pull request.