---
title: "Create a token"
slug: "create-a-token"
abstract: "Overview of the Create a token resource, which generates a token."
---
# Create a token

A user can only have one token, which means that generating a new token will invalidate the previous one. Only someone with superuser privileges can generate a new token.

```html
PUT /api/authenticate

```

## Body parameters

| Name | Type | Description |
| --- | --- | --- |
| `user_name` | `String` | The username of the user to generate a new token for |

## Body examples

```html
{
  "user_name":"Username"
}

```

## Response

| Response | Description |
| --- | --- |
| `200 Ok` | Returns the newly generated token to be used in the `X-Auth-Token` header |

## Response examples

```json
Status: 200 Ok

{
  "token" : "newly-generated-token-to-be-used-in-X-Auth-Token-header"
}

```