Create access token

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name?string

abilities?

TokenAbilities is what a token may do — three answers, not one level.

A level forces an order the real question does not have: a recipe importer reads and never writes, a shopping shortcut writes and should never delete.

listUids?array<string>

The Lists it may reach. A token that names none reaches none, unless all_lists is set instead.

allLists?boolean

Reach every List the Member can, including ones made later. Not the same as naming them all: that would stop at the Lists that exist today.

expiresAt?string

RFC 3339, or empty for a token that does not expire.

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/access-tokens" \  -H "Content-Type: application/json" \  -d '{}'

{  "token": {    "uid": "string",    "name": "string",    "abilities": {      "read": true,      "write": true,      "delete": true    },    "listNames": [      "string"    ],    "allLists": true,    "expiresAt": "string",    "lastUsedAt": "string",    "createdAt": "string",    "memberName": "string"  },  "secret": "string"}

Create access token

Request Body

Response Body

200application/json

defaultapplication/json

`application/json`

`application/json`