apps
Creates, updates, deletes, gets or lists an apps resource.
Overview
| Name | apps |
| Type | Resource |
| Id | linode.profile.apps |
Fields
The following fields are returned by SELECT queries:
- get
- list
The app requested.
| Name | Datatype | Description |
|---|---|---|
id | integer | Read-only This authorization's ID, used for revoking access. |
created | string (date-time) | Filterable, Read-only When this app was authorized. (example: 2018-01-01T00:01:01) |
expiry | string (date-time) | Filterable, Read-only When the app's access to your account expires. If null, the app's access must be revoked manually. (example: 2018-01-15T00:01:01) |
label | string | Filterable, Read-only The name of the application you've authorized. (example: example-app) |
scopes | string (oauth-scopes) | Read-only The OAuth scopes this app was authorized with. This defines what parts of your Account the app is allowed to access. (example: linodes:read_only) |
thumbnail_url | string (url) | Read-only The URL at which this app's thumbnail may be accessed. |
website | string (url) | Read-only The website where you can get more information about this app. (example: example.org) |
A paginated list of apps you've authorized.
| Name | Datatype | Description |
|---|---|---|
id | integer | Read-only This authorization's ID, used for revoking access. |
created | string (date-time) | Filterable, Read-only When this app was authorized. (example: 2018-01-01T00:01:01) |
expiry | string (date-time) | Filterable, Read-only When the app's access to your account expires. If null, the app's access must be revoked manually. (example: 2018-01-15T00:01:01) |
label | string | Filterable, Read-only The name of the application you've authorized. (example: example-app) |
scopes | string (oauth-scopes) | Read-only The OAuth scopes this app was authorized with. This defines what parts of your Account the app is allowed to access. (example: linodes:read_only) |
thumbnail_url | string (url) | Read-only The URL at which this app's thumbnail may be accessed. |
website | string (url) | Read-only The website where you can get more information about this app. (example: example.org) |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | appId | Returns information about a single app you've authorized to access your account. Learn more... Learn more... | |
list | select | page, page_size | This is a collection of OAuth apps that you've given access to your account, and includes the level of access granted. Learn more... Learn more... | |
delete | delete | appId | Expires this app token. This token can no longer be used to access your account. Learn more... Learn more... |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
appId | string | The authorized app ID to manage. |
page | integer | The page of a collection to return. |
page_size | integer | The number of items to return per page. |
SELECT examples
- get
- list
Returns information about a single app you've authorized to access your account.
Learn more...
Learn more...
SELECT
id,
created,
expiry,
label,
scopes,
thumbnail_url,
website
FROM linode.profile.apps
WHERE appId = '{{ appId }}' -- required
;
This is a collection of OAuth apps that you've given access to your account, and includes the level of access granted.
Learn more...
Learn more...
SELECT
id,
created,
expiry,
label,
scopes,
thumbnail_url,
website
FROM linode.profile.apps
WHERE page = '{{ page }}'
AND page_size = '{{ page_size }}'
;
DELETE examples
- delete
Expires this app token. This token can no longer be used to access your account.
Learn more...
Learn more...
DELETE FROM linode.profile.apps
WHERE appId = '{{ appId }}' --required
;