List a user's access tokens

GET 
https://api.motherduck.com/v1/users/:username/tokens

List a user's access tokens

Request

Path Parameters

username stringrequired

Possible values: <= 255 characters

user within the organization

Responses

200

Successful response

application/json

Schema

Schema

tokens object[]required
Array [
iduuidrequired
namestring
expire_atstring
Time token expires at
created_tsstringrequired
Time token was originally created
read_onlybooleanrequired
token_typestringrequired
Possible values: [read_write, read_scaling]
]

Example (auto)

{
  "tokens": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "string",
      "expire_at": "string",
      "created_ts": "string",
      "read_only": true,
      "token_type": "read_write"
    }
  ]
}

400

Bad Request

application/json

Schema

Schema

messagestringrequired
The error message
Example: Bad Request
codestringrequired
The error code
Example: BAD_REQUEST
issues object[]
An array of issues that were responsible for the error
Array [
messagestringrequired
]

Example (auto)

{
  "code": "BAD_REQUEST",
  "message": "Bad Request",
  "issues": []
}

401

Invalid Credentials

application/json

Schema

Schema

messagestringrequired
The error message
Example: Invalid Credentials
codestringrequired
The error code
Example: UNAUTHORIZED
issues object[]
An array of issues that were responsible for the error
Array [
messagestringrequired
]

Example (auto)

{
  "code": "UNAUTHORIZED",
  "message": "Invalid Credentials",
  "issues": []
}

403

Unauthorized

application/json

Schema

Schema

messagestringrequired
The error message
Example: Unauthorized
codestringrequired
The error code
Example: FORBIDDEN
issues object[]
An array of issues that were responsible for the error
Array [
messagestringrequired
]

Example (auto)

{
  "code": "FORBIDDEN",
  "message": "Unauthorized",
  "issues": []
}

404

Not Found

application/json

Schema

Schema

messagestringrequired
The error message
Example: Not Found
codestringrequired
The error code
Example: NOT_FOUND
issues object[]
An array of issues that were responsible for the error
Array [
messagestringrequired
]

Example (auto)

{
  "code": "NOT_FOUND",
  "message": "Not Found",
  "issues": []
}

500

Internal Error

application/json

Schema

Schema

messagestringrequired
The error message
Example: Internal Error
codestringrequired
The error code
Example: INTERNAL_SERVER_ERROR
issues object[]
An array of issues that were responsible for the error
Array [
messagestringrequired
]

Example (auto)

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "Internal Error",
  "issues": []
}

Authorization: http

name: Authorizationtype: httpscheme: bearer

• curl
• nodejs
• python
• go
• java

• CURL

curl -L 'https://api.motherduck.com/v1/users/:username/tokens' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <token>'

Request Collapse all

Base URL

https://api.motherduck.com

Auth

Bearer Token

Parameters

username — pathrequired

ResponseClear

Click the Send API Request button above and see the response here!