Access tokens

Reset access token (legacy)

Deprecated

POST
/api/v2/tokens/{id}/reset

Reset an access token's secret key with an optional expiry time for the old key. Use of this legacy handler is discouraged. Patch the expiry field on the token directly instead.

Authorization

ApiKey read, write
Authorization<token>

In: header

Scope: read, write

Path Parameters

id*string

The ID of the access token to update

Formatstring

Query Parameters

expiry?integer

An expiration time for the old token key, expressed as a Unix epoch time in milliseconds. By default, the token will expire immediately.

Formatint64

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/v2/tokens/string/reset"
{  "_id": "61095542756dba551110ae21",  "ownerId": "569f514156e003339cfd3917",  "memberId": "569f514183f2164430000002",  "_member": {    "_links": {      "self": {        "href": "/api/v2/members/569f183514f4432160000007",        "type": "application/json"      }    },    "_id": "569f183514f4432160000007",    "firstName": "Ariel",    "lastName": "Flores",    "role": "admin",    "email": "ariel@acme.com"  },  "name": "Example reader token",  "description": "A reader token used in testing and examples",  "creationDate": "1628001602644",  "lastModified": "1628001602644",  "customRoleIds": [],  "inlineRole": [],  "role": "reader",  "token": "1234",  "serviceToken": false,  "_links": {    "parent": {      "href": "/api/v2/tokens",      "type": "application/json"    },    "self": {      "href": "/api/v2/tokens/61095542756dba551110ae21",      "type": "application/json"    }  },  "defaultApiVersion": 20240415,  "lastUsed": "0",  "expiry": "1735689600000"}