Page Comparison

Table of Contents

minLevel	2
maxLevel	2
outline	false
type	flat
separator	brackets
printable	true

...

Endpoints and methods

Description

Status

colour	Yellow
title	GET

/v2/accounts/{accountName}/tokens ^{see below}

Get a list of all the tokens for the provided account.

Status

colour	Yellow
title	GET

/v2/accounts/{accountName}/tokens/{tokenId} ^{see below}

Returns all the information of a single token, including the actual token.

Status

colour	Green
title	POST

/v2/accounts/{accountName}/tokens ^{see below}

Create a new token.

Status

colour	Blue
title	PUT

/v2/accounts/{accountName}/tokens/{tokenId}/enable ^{see below}

Enable a token.

Status

colour	Blue
title	PUT

/v2/accounts/{accountName}/tokens/{tokenId}/disable ^{see below}

Disable a token.

Status

colour	Blue
title	PUT

/v2/accounts/{accountName}/tokens/{tokenId}/rename ^{see below}

Change the name associated with a token.

Status

colour	Red
title	DELETE

/v2/accounts/{accountName}/tokens/{tokenId} ^{see below}

Delete a token.

Endpoints and methods

Anchor
path1
path1
GET `/v2/accounts/{accountName}/tokens`

...

Expand

title	Request

Path parameters

Add the following path parameters as part of the endpoint:

Parameter	Type	Description
`accountName` ^required	`string`	The name of the account.

Find below a request example:

Code Block
https://api-us.devo.com/xxx/v2/accounts/sampleAccount/tokens

Expand

title	Response

Code

Description

200

Successful response. List of tokens retrieved.

Code Block

[
  {
    "name": "a",
    "id": 1,
    "scope": "table://*.** level://admin",
    "owner": "web-testing+auto-admin@devo.com",
    "user": "web-testing+auto-admin@devo.com",
    "audience": "apiv2-admin aggregations apiv2",
    "token_type": "Bearer",
    "active": true,
    "expiration": "2024-11-26T14:38:18.000+0000",
    "account": "sampleAccount",
    "created": "2024-11-25T14:38:18.000+0000",
    "updated": "2024-11-25T14:38:18.000+0000",
    "expires_in_seconds": 86400
  },
  {
    "name": "b",
    "id": 2,
    "scope": "table://*.** level://admin",
    "owner": "web-testing+auto-admin@devo.com",
    "user": "web-testing+auto-admin@devo.com",
    "audience": "apiv2-admin aggregations apiv2",
    "token_type": "Bearer",
    "active": true,
    "expiration": "2024-11-26T14:38:18.000+0000",
    "account": "sampleAccount",
    "created": "2024-11-25T14:38:18.000+0000",
    "updated": "2024-11-25T14:38:18.000+0000",
    "expires_in_seconds": 86400
  }
]

4xx

Bad request.

Code Block
{ "error": { "code": 4xx, "message": "string" } }

...

Anchor
path1
path1
GET `/v2/accounts/{accountName}/tokens/{tokenId}`

...

Expand

title	Request

Path parameters

Add the following path parameters as part of the endpoint:

Parameter	Type	Description
`accountName` ^required	`string`	The name of the account.
`tokenId` ^required	`string`	The ID of the token.

Find below a request example:

Code Block
https://api-us.devo.com/xxx/v2/accounts/sampleAccount/tokens/3

Expand

title	Response

Code

Description

200

Successful response. Token retrieved.

Code Block

{
  "name": "test",
  "id": 3,
  "scope": "table://*.** level://admin",
  "owner": "web-testing+auto-admin@devo.com",
  "user": "web-testing+auto-admin@devo.com",
  "audience": "apiv2-admin aggregations apiv2",
  "token_type": "Bearer",
  "active": true,
  "expiration": "2024-11-26T14:38:18.000+0000",
  "token": "31089320378051f1a2ee17c14028f056",
  "account": "sampleAccount",
  "created": "2024-11-25T14:38:18.000+0000",
  "updated": "2024-11-25T14:38:18.000+0000",
  "expires_in_seconds": 86400
}

4xx

Bad request.

Code Block
{ "error": { "code": 4xx, "message": "string" } }

...

Anchor
path2
path2
POST`/v2/accounts/{accountName}/tokens`

...

Expand

title	Request

Path parameters

Add the following path parameters as part of the endpoint:

Parameter	Type	Description
`accountName` ^required	`string`	The name of the account.

Payload:

Code Block
{ "name": "string", "owner": "email", "user": "email", "audience": "string", "scopes": "string", "expiresInSeconds": 86400 }

name is optional, and defaults to 'Unnamed' when not present.
user is optional and only required when a user is creating a token on behalf of another user. The credentials are resolved for the value of this field (which defaults to the owner when not present).
audience is required (samples: apiv2, apiv2-admin, alerts, aggregations, http).
scopes is optional and defaults to 'default' when not present.
expiresInSeconds is optional and defaults to 86400 when not present. Use the value -1 to create a permanent token.

Find below a request example:

Code Block
https://api-us.devo.com/xxx/v2/accounts/sampleAccount/tokens

...

Info
Creating a token returns the `location` header with the URI where the resource can be located.

...

Anchor
path11
path11
PUT`/v2/accounts/{accountName}/tokens/{tokenId}/enable`

...

Expand

title	Request

Path parameters

Add the following path parameters as part of the endpoint:

Parameter	Type	Description
`accountName` ^required	`string`	The name of the account.
`tokenId` ^required	`string`	The ID of the token.

Find below a request example:

Code Block
https://api-us.devo.com/xxx/v2/accounts/sampleAccount/tokens/3/enable

Expand

title	Response

Code

Description

200

Successful response. Token enabled.

4xx

Bad request.

Code Block
{ "error": { "code": 4xx, "message": "string" } }

...

Anchor
path11
path11
PUT`/v2/accounts/{accountName}/tokens/{tokenId}/disable`

...

Expand

title	Request

Path parameters

Add the following path parameters as part of the endpoint:

Parameter	Type	Description
`accountName` ^required	`string`	The name of the account.
`tokenId` ^required	`string`	The ID of the token.

Find below a request example:

Code Block
https://api-us.devo.com/xxx/v2/accounts/sampleAccount/tokens/3/disable

Expand

title	Response

Code

Description

200

Successful response. Token disabled.

4xx

Bad request.

Code Block
{ "error": { "code": 4xx, "message": "string" } }

...

Anchor
path11
path11
PUT`/v2/accounts/{accountName}/tokens/{tokenId}/rename`

...

Expand

title	Request

Path parameters

Add the following path parameters as part of the endpoint:

Parameter	Type	Description
`accountName` ^required	`string`	The name of the account.
`tokenId` ^required	`string`	The ID of the token.

Payload:

Code Block
{ "value": "your new token name" }

If the new name is empty or null, the service will still return OK, but the token name will remain unchanged.

Find below a request example:

Code Block
https://api-us.devo.com/xxx/v2/accounts/sampleAccount/tokens/3/rename

Expand

title	Response

Code

Description

200

Successful response. Token renamed.

4xx

Bad request.

Code Block
{ "error": { "code": 4xx, "message": "string" } }

...

Anchor
path15
path15
DELETE`/v2/accounts/{accountName}/tokens/{tokenId}`

...

Expand

title	Request

Path parameters

Add the following path parameters as part of the endpoint:

Parameter	Type	Description
`accountName` ^required	`string`	The name of the account.
`tokenId` ^required	`string`	The ID of the token.

Find below a request example:

Code Block
https://api-us.devo.com/xxx/v2/accounts/sampleAccount/tokens/3

...

Version	Old Version 5	New Version 6
Changes made by	Alvaro de la Serna Martinez	Alvaro de la Serna Martinez
Saved on	Nov 26, 2024	Nov 27, 2024

Versions Compared

Key

Endpoints and methods

Anchor
path1
path1
GET `/v2/accounts/{accountName}/tokens`

Path parameters

Anchor
path1
path1
GET `/v2/accounts/{accountName}/tokens/{tokenId}`

Path parameters

Anchor
path2
path2
POST`/v2/accounts/{accountName}/tokens`

Path parameters

Anchor
path11
path11
PUT`/v2/accounts/{accountName}/tokens/{tokenId}/enable`

Path parameters

Anchor
path11
path11
PUT`/v2/accounts/{accountName}/tokens/{tokenId}/disable`

Path parameters

Anchor
path11
path11
PUT`/v2/accounts/{accountName}/tokens/{tokenId}/rename`

Path parameters

Anchor
path15
path15
DELETE`/v2/accounts/{accountName}/tokens/{tokenId}`

Path parameters

Page Comparison

Versions Compared

Key

Endpoints and methods

Anchorpath1path1 GET /v2/accounts/{accountName}/tokens

Path parameters

Anchorpath1path1 GET /v2/accounts/{accountName}/tokens/{tokenId}

Path parameters

Anchorpath2path2 POST/v2/accounts/{accountName}/tokens

Path parameters

Anchorpath11path11 PUT/v2/accounts/{accountName}/tokens/{tokenId}/enable

Path parameters

Anchorpath11path11 PUT/v2/accounts/{accountName}/tokens/{tokenId}/disable

Path parameters

Anchorpath11path11 PUT/v2/accounts/{accountName}/tokens/{tokenId}/rename

Path parameters

Anchorpath15path15 DELETE/v2/accounts/{accountName}/tokens/{tokenId}

Path parameters

Anchor
path1
path1
GET `/v2/accounts/{accountName}/tokens`

Anchor
path1
path1
GET `/v2/accounts/{accountName}/tokens/{tokenId}`

Anchor
path2
path2
POST`/v2/accounts/{accountName}/tokens`

Anchor
path11
path11
PUT`/v2/accounts/{accountName}/tokens/{tokenId}/enable`

Anchor
path11
path11
PUT`/v2/accounts/{accountName}/tokens/{tokenId}/disable`

Anchor
path11
path11
PUT`/v2/accounts/{accountName}/tokens/{tokenId}/rename`

Anchor
path15
path15
DELETE`/v2/accounts/{accountName}/tokens/{tokenId}`