# Token

## Generate a new API token

**post** `/api/token`

Generate a new API token

### Returns

- `errors: array of object { code, message }`

  - `code: number`

  - `message: string`

- `messages: array of object { code, message }`

  - `code: number`

  - `message: string`

- `result: object { id, token, hint }`

  - `id: string`

  - `token: string`

  - `hint: string`

- `success: boolean`

### Example

```http
curl https://rake.dev/api/token \
    -X POST \
    -H "Authorization: Bearer $RAKE_API_KEY"
```

#### Response

```json
{
  "errors": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "result": {
    "id": "id",
    "token": "token",
    "hint": "hint"
  },
  "success": true
}
```

## Revoke an API token

**delete** `/api/token/{id}`

Revoke an API token

### Path Parameters

- `id: string`

### Returns

- `errors: array of object { code, message }`

  - `code: number`

  - `message: string`

- `messages: array of object { code, message }`

  - `code: number`

  - `message: string`

- `result: object { id }`

  - `id: string`

- `success: boolean`

### Example

```http
curl https://rake.dev/api/token/$ID \
    -X DELETE \
    -H "Authorization: Bearer $RAKE_API_KEY"
```

#### Response

```json
{
  "errors": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message"
    }
  ],
  "result": {
    "id": "id"
  },
  "success": true
}
```

## Domain Types

### Token Create Response

- `TokenCreateResponse object { errors, messages, result, success }`

  - `errors: array of object { code, message }`

    - `code: number`

    - `message: string`

  - `messages: array of object { code, message }`

    - `code: number`

    - `message: string`

  - `result: object { id, token, hint }`

    - `id: string`

    - `token: string`

    - `hint: string`

  - `success: boolean`

### Token Revoke Response

- `TokenRevokeResponse object { errors, messages, result, success }`

  - `errors: array of object { code, message }`

    - `code: number`

    - `message: string`

  - `messages: array of object { code, message }`

    - `code: number`

    - `message: string`

  - `result: object { id }`

    - `id: string`

  - `success: boolean`