List the named tokens (owner only).

POST

/datanotes/tokens/

curl --request POST \
  --url https://example.com/datanotes/tokens/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

Authorizations

• bearer

Request Body

Media typeapplication/json

object

Example ^generated

{}

Responses

200

Done.

Media typeapplication/json

object

tokens

Array<object>

A named token as the registry shows it (never its value).

object

name

required

string

description

string

write

required

Array<string>

ddl

required

boolean

maintain

boolean

autolink

The default of its writes for automatic links (absent: the database’s setting).

boolean

created_at

required

string

updated_at

required

string

last_seen

The last request made with it (saved within a minute).

string

Example ^generated

{
  "tokens": [
    {
      "name": "example",
      "description": "example",
      "write": [
        "example"
      ],
      "ddl": true,
      "maintain": true,
      "autolink": true,
      "created_at": "example",
      "updated_at": "example",
      "last_seen": "example"
    }
  ]
}

400

Bad input: the body is not a JSON object, or an argument is unknown, missing or of the wrong type.

Media typeapplication/json

object

error

required

What went wrong, for a person or an agent.

string

Example ^generated

{
  "error": "example"
}

401

Missing or wrong bearer token.

Media typeapplication/json

object

error

required

What went wrong, for a person or an agent.

string

Example ^generated

{
  "error": "example"
}

403

A named token beyond its permissions (the engine’s administration, tables outside its write patterns, schema changes without ddl).

Media typeapplication/json

object

error

required

What went wrong, for a person or an agent.

string

Example ^generated

{
  "error": "example"
}

500

Unexpected error.

Media typeapplication/json

object

error

required

What went wrong, for a person or an agent.

string

Example ^generated

{
  "error": "example"
}