Create

Generate new bearer authentication token.

Endpoint

POST /api/v1/user/tokens

Parameters

Body parameters

Parameter	Type	Required	Description
name	string	yes	The name of the token.

Request example

cURL

curl --location --request POST 'https://files.ro/api/v1/user/tokens' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {token}' \
--data-raw '{
  "name": "My Custom App"
}'

Response

201 Created

{
  "accessToken": {
    "id": 1,
    "tokenable_type": "App\\Users\\Models\\User",
    "tokenable_id": "user_123",
    "name": "CLI",
    "abilities": [
      "*"
    ],
    "last_used_at": "2024-01-01T00:00:00.000000Z",
    "expires_at": null,
    "created_at": "2024-01-01T00:00:00.000000Z",
    "updated_at": "2024-01-01T00:00:00.000000Z"
  },
  "plainTextToken": "1|plain_text_token"
}

401 Unauthorized

{
  "type": "error",
  "message": "You are not authorized"
}

422 Unprocessable Entity

{
  "message": "The given data was invalid.",
  "errors": {
    "field": [
      "The field is required."
    ]
  }
}