apps.md 832 Bytes
Newer Older
Eugen Rochko's avatar
Eugen Rochko committed
1
---
2
title: Apps
Eugen Rochko's avatar
Eugen Rochko committed
3 4
menu:
  docs:
5
    parent: rest-api
Eugen Rochko's avatar
Eugen Rochko committed
6 7
    weight: 10
---
Eugen Rochko's avatar
Eugen Rochko committed
8 9 10

## POST /api/v1/apps

Eugen Rochko's avatar
Eugen Rochko committed
11 12
Create a new application to obtain OAuth2 credentials.

Eugen Rochko's avatar
Eugen Rochko committed
13 14 15 16 17 18 19 20
Returns [App]({{< relref "entities.md#app" >}}) with `client_id` and `client_secret`

### Resource information

{{< api_method_info auth="No" user="No" version="0.0.0" >}}

### Parameters

Eugen Rochko's avatar
Eugen Rochko committed
21 22 23 24 25 26 27 28
|Name|Description|Required|
|----|-----------|:------:|
| `client_name` | Name of your application | Required |
| `redirect_uris` | Where the user should be redirected after authorization | Required |
| `scopes` | Space separated list of [scopes]({{< relref "permissions.md" >}}) | Required |
| `website` | URL to the homepage of your app | Optional |

> To display the authorization code to the end-user instead of redirecting to a web page, use `urn:ietf:wg:oauth:2.0:oob` in `redirect_uris`