Profile

View Authorized App

get
https://api.linode.com/v4/profile/apps/{appId}

Returns information about a single app you've authorized to access your Account.

Authorizations

Personal Access Token
OAuth: ( account:read_only)

Path Parameters

appId
Required
integer

The authorized app ID to manage.

Request Samples

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

Response Samples

{
  "id": 1234,
  "created": "2018-01-01T00:01:01",
  "label": "example-app",
  "thumbnail_url": "",
  "expiry": "2018-01-15T00:01:01",
  "scopes": "linodes:read_only",
  "website": "example.org"
}

Responses

200: The app requested.

id
integer

This authorization's ID, used for revoking access.

created
Filterable
string <date-time>

When this app was authorized.

label
string

The name of the application you've authorized.

thumbnail_url
string <url>

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

expiry
string <date-time>

When this app's access token expires. Please note that apps may still have active refresh tokens after this time passes.

scopes
string <oauth-scopes>

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

website
string <url>

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

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.

Revoke App Access

delete
https://api.linode.com/v4/profile/apps/{appId}

Expires this app token. This token may no longer be used to access your Account.

Authorizations

Personal Access Token
OAuth: ( account:read_write)

Path Parameters

appId
Required
integer

The authorized app ID to manage.

Request Samples

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

Response Samples

{}

Responses

200: App's authorization has been revoked.

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.