Skip to content

Commit ab9bc59

Browse files
[New] List Logins and View Login (#247)
Added /profile/logins endpoint Added /logins/{loginId} endpoint Added Logins schema object
1 parent 27cde82 commit ab9bc59

File tree

1 file changed

+113
-0
lines changed

1 file changed

+113
-0
lines changed

openapi.yaml

Lines changed: 113 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11054,6 +11054,90 @@ paths:
1105411054
- lang: CLI
1105511055
source: >
1105611056
linode-cli profile token-delete 123
11057+
/profile/logins:
11058+
description: >
11059+
Returns a collection of successful account logins for this user during the last
11060+
90 days.
11061+
x-linode-cli-command: profile
11062+
get:
11063+
tags:
11064+
- Profile
11065+
summary: List Logins
11066+
description: >
11067+
Returns a collection of successful account logins from this user during the last
11068+
90 days.
11069+
operationId: getProfileLogins
11070+
x-linode-cli-action: logins-list
11071+
security:
11072+
- personalAccessToken: []
11073+
- oauth:
11074+
- account:read_only
11075+
responses:
11076+
'200':
11077+
description: >
11078+
An array of successful account logins from this user during
11079+
the last 90 days.
11080+
content:
11081+
application/json:
11082+
schema:
11083+
type: object
11084+
properties:
11085+
data:
11086+
type: array
11087+
items:
11088+
$ref: '#/components/schemas/Logins'
11089+
default:
11090+
$ref: '#/components/responses/ErrorResponse'
11091+
x-code-samples:
11092+
- lang: Shell
11093+
source: >
11094+
curl -H "Authorization: Bearer $TOKEN" \
11095+
https://api.linode.com/v4/profile/logins
11096+
- lang: CLI
11097+
source: >
11098+
linode-cli profile logins-list
11099+
/profile/logins/{loginId}:
11100+
description: >
11101+
A login object that displays information about a successful
11102+
account login from this user.
11103+
parameters:
11104+
- name: loginId
11105+
in: path
11106+
description: The ID of the login object to access.
11107+
required: true
11108+
schema:
11109+
type: integer
11110+
x-linode-cli-command: profile
11111+
get:
11112+
tags:
11113+
- Profile
11114+
summary: View Login
11115+
description: >
11116+
Returns a login object displaying information about a successful
11117+
account login from this user.
11118+
operationId: getProfileLogin
11119+
x-linode-cli-action: login-view
11120+
security:
11121+
- personalAccessToken: []
11122+
- oauth:
11123+
- account:read_only
11124+
responses:
11125+
'200':
11126+
description: The requested login object.
11127+
content:
11128+
application/json:
11129+
schema:
11130+
$ref: '#/components/schemas/Logins'
11131+
default:
11132+
$ref: '#/components/responses/ErrorResponse'
11133+
x-code-samples:
11134+
- lang: Shell
11135+
source: >
11136+
curl -H "Authorization: Bearer $TOKEN" \
11137+
https://api.linode.com/v4/profile/logins/1234
11138+
- lang: CLI
11139+
source: >
11140+
linode-cli profile login-view 1234
1105711141
/profile/devices:
1105811142
x-linode-cli-command: profile
1105911143
description: >
@@ -15828,6 +15912,35 @@ components:
1582815912
When this Longview Client was last updated.
1582915913
example: 2018-01-01T00:01:01
1583015914
readOnly: true
15915+
Logins:
15916+
type: object
15917+
description: >
15918+
A collection of successful account logins from this user during the last
15919+
90 days
15920+
properties:
15921+
id:
15922+
type: integer
15923+
description: >
15924+
The unique ID of this login object.
15925+
example: 1234
15926+
readOnly: true
15927+
x-linode-cli-display: 1
15928+
datetime:
15929+
type: string
15930+
format: date-time
15931+
description: >
15932+
When the login was initiated.
15933+
example: '2018-01-01T00:01:01'
15934+
readOnly: true
15935+
x-linode-cli-display: 2
15936+
ip:
15937+
type: string
15938+
format: ip
15939+
description: >
15940+
The remote IP address that requested the login.
15941+
example: 192.0.2.0
15942+
readOnly: true
15943+
x-linode-cli-display: 3
1583115944
LongviewSubscription:
1583215945
type: object
1583315946
description: >

0 commit comments

Comments
 (0)