Profile

Authorized Apps List

get
https://api.linode.com/v4/profile/apps

This is a collection of OAuth apps that you've given access to your Account, and includes the level of access granted.

Query Parameters

page
integer > = 1
Default: 1

The page of a collection to return.

page_size
integer [25 .. 500]
Default: 100

The number of items to return per page.

Request Samples

curl -H "Authorization: Bearer $TOKEN" \
    https://api.linode.com/v4/profile/apps

Response Samples

{
  "data": [
    {
      "id": "",
      "created": "2018-01-01T00:01:01",
      "label": "example-app",
      "thumbnail_url": "",
      "expiry": "2018-01-15T00:01:01",
      "scopes": "linodes:read_only",
      "website": "example.org"
    }
  ],
  "page": 1,
  "pages": 1,
  "results": 1
}

Responses

200: A paginated list of apps you've authorized.

data
array of objects
id
integer

This authorization's ID, used for revoking access.

created
Filterable
string

When this app was authorized.

label
Filterable
string

The name of the application you've authorized.

thumbnail_url
string

The URL at which this app's thumbnail may be accessed.

expiry
Filterable
Nullable
string

When the app's access to your account expires. If null, the app's access must be revoked manually.

scopes
string

The OAuth scopes this app was authorized with. This defines what parts of your Account the app is allowed to access.

website
string

The website where you can get more information about this app.

page
integer

The current page.

pages
integer

The total number of pages.

results
integer

The total number of results.

default: Error

errors
array of objects
reason
string

What happened to cause this error. In most cases, this can be fixed immediately by changing the data you sent in the request, but in some cases you will be instructed to open a Support Ticket or perform some other action before you can complete the request successfully.

field
string

The field in the request that caused this error. This may be a path, separated by periods in the case of nested fields. In some cases this may come back as "null" if the error is not specific to any single element of the request.