# Tokens

## List tokens.

`aisearch.tokens.list(TokenListParams**kwargs)  -> SyncV4PagePaginationArray[TokenListResponse]`

**get** `/accounts/{account_id}/ai-search/tokens`

List tokens.

### Parameters

- `account_id: str`

- `order_by: Optional[Literal["created_at"]]`

  Order By Column Name

  - `"created_at"`

- `order_by_direction: Optional[Literal["asc", "desc"]]`

  Order By Direction

  - `"asc"`

  - `"desc"`

- `page: Optional[int]`

- `per_page: Optional[int]`

### Returns

- `class TokenListResponse: …`

  - `id: str`

  - `cf_api_id: str`

  - `created_at: datetime`

  - `modified_at: datetime`

  - `name: str`

  - `created_by: Optional[str]`

  - `enabled: Optional[bool]`

  - `legacy: Optional[bool]`

  - `modified_by: Optional[str]`

### Example

```python
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
page = client.aisearch.tokens.list(
    account_id="c3dc5f0b34a14ff8e1b3ec04895e1b22",
)
page = page.result[0]
print(page.id)
```

#### Response

```json
{
  "result": [
    {
      "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
      "cf_api_id": "cf_api_id",
      "created_at": "2019-12-27T18:11:19.117Z",
      "modified_at": "2019-12-27T18:11:19.117Z",
      "name": "name",
      "created_by": "created_by",
      "enabled": true,
      "legacy": true,
      "modified_by": "modified_by"
    }
  ],
  "success": true
}
```

## Create new tokens.

`aisearch.tokens.create(TokenCreateParams**kwargs)  -> TokenCreateResponse`

**post** `/accounts/{account_id}/ai-search/tokens`

Create a new tokens.

### Parameters

- `account_id: str`

- `cf_api_id: str`

- `cf_api_key: str`

- `name: str`

### Returns

- `class TokenCreateResponse: …`

  - `id: str`

  - `cf_api_id: str`

  - `created_at: datetime`

  - `modified_at: datetime`

  - `name: str`

  - `created_by: Optional[str]`

  - `enabled: Optional[bool]`

  - `legacy: Optional[bool]`

  - `modified_by: Optional[str]`

### Example

```python
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
token = client.aisearch.tokens.create(
    account_id="c3dc5f0b34a14ff8e1b3ec04895e1b22",
    cf_api_id="cf_api_id",
    cf_api_key="cf_api_key",
    name="name",
)
print(token.id)
```

#### Response

```json
{
  "result": {
    "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "cf_api_id": "cf_api_id",
    "created_at": "2019-12-27T18:11:19.117Z",
    "modified_at": "2019-12-27T18:11:19.117Z",
    "name": "name",
    "created_by": "created_by",
    "enabled": true,
    "legacy": true,
    "modified_by": "modified_by"
  },
  "success": true
}
```

## Read tokens.

`aisearch.tokens.read(strid, TokenReadParams**kwargs)  -> TokenReadResponse`

**get** `/accounts/{account_id}/ai-search/tokens/{id}`

Read tokens.

### Parameters

- `account_id: str`

- `id: str`

### Returns

- `class TokenReadResponse: …`

  - `id: str`

  - `cf_api_id: str`

  - `created_at: datetime`

  - `modified_at: datetime`

  - `name: str`

  - `created_by: Optional[str]`

  - `enabled: Optional[bool]`

  - `legacy: Optional[bool]`

  - `modified_by: Optional[str]`

### Example

```python
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
response = client.aisearch.tokens.read(
    id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    account_id="c3dc5f0b34a14ff8e1b3ec04895e1b22",
)
print(response.id)
```

#### Response

```json
{
  "result": {
    "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "cf_api_id": "cf_api_id",
    "created_at": "2019-12-27T18:11:19.117Z",
    "modified_at": "2019-12-27T18:11:19.117Z",
    "name": "name",
    "created_by": "created_by",
    "enabled": true,
    "legacy": true,
    "modified_by": "modified_by"
  },
  "success": true
}
```

## Update tokens.

`aisearch.tokens.update(strid, TokenUpdateParams**kwargs)  -> TokenUpdateResponse`

**put** `/accounts/{account_id}/ai-search/tokens/{id}`

Update tokens.

### Parameters

- `account_id: str`

- `id: str`

- `cf_api_id: str`

- `cf_api_key: str`

- `name: str`

### Returns

- `class TokenUpdateResponse: …`

  - `id: str`

  - `cf_api_id: str`

  - `created_at: datetime`

  - `modified_at: datetime`

  - `name: str`

  - `created_by: Optional[str]`

  - `enabled: Optional[bool]`

  - `legacy: Optional[bool]`

  - `modified_by: Optional[str]`

### Example

```python
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
token = client.aisearch.tokens.update(
    id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    account_id="c3dc5f0b34a14ff8e1b3ec04895e1b22",
    cf_api_id="cf_api_id",
    cf_api_key="cf_api_key",
    name="name",
)
print(token.id)
```

#### Response

```json
{
  "result": {
    "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "cf_api_id": "cf_api_id",
    "created_at": "2019-12-27T18:11:19.117Z",
    "modified_at": "2019-12-27T18:11:19.117Z",
    "name": "name",
    "created_by": "created_by",
    "enabled": true,
    "legacy": true,
    "modified_by": "modified_by"
  },
  "success": true
}
```

## Delete tokens.

`aisearch.tokens.delete(strid, TokenDeleteParams**kwargs)  -> TokenDeleteResponse`

**delete** `/accounts/{account_id}/ai-search/tokens/{id}`

Delete tokens.

### Parameters

- `account_id: str`

- `id: str`

### Returns

- `class TokenDeleteResponse: …`

  - `id: str`

  - `cf_api_id: str`

  - `created_at: datetime`

  - `modified_at: datetime`

  - `name: str`

  - `created_by: Optional[str]`

  - `enabled: Optional[bool]`

  - `legacy: Optional[bool]`

  - `modified_by: Optional[str]`

### Example

```python
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_token=os.environ.get("CLOUDFLARE_API_TOKEN"),  # This is the default and can be omitted
)
token = client.aisearch.tokens.delete(
    id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    account_id="c3dc5f0b34a14ff8e1b3ec04895e1b22",
)
print(token.id)
```

#### Response

```json
{
  "result": {
    "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
    "cf_api_id": "cf_api_id",
    "created_at": "2019-12-27T18:11:19.117Z",
    "modified_at": "2019-12-27T18:11:19.117Z",
    "name": "name",
    "created_by": "created_by",
    "enabled": true,
    "legacy": true,
    "modified_by": "modified_by"
  },
  "success": true
}
```

## Domain Types

### Token List Response

- `class TokenListResponse: …`

  - `id: str`

  - `cf_api_id: str`

  - `created_at: datetime`

  - `modified_at: datetime`

  - `name: str`

  - `created_by: Optional[str]`

  - `enabled: Optional[bool]`

  - `legacy: Optional[bool]`

  - `modified_by: Optional[str]`

### Token Create Response

- `class TokenCreateResponse: …`

  - `id: str`

  - `cf_api_id: str`

  - `created_at: datetime`

  - `modified_at: datetime`

  - `name: str`

  - `created_by: Optional[str]`

  - `enabled: Optional[bool]`

  - `legacy: Optional[bool]`

  - `modified_by: Optional[str]`

### Token Read Response

- `class TokenReadResponse: …`

  - `id: str`

  - `cf_api_id: str`

  - `created_at: datetime`

  - `modified_at: datetime`

  - `name: str`

  - `created_by: Optional[str]`

  - `enabled: Optional[bool]`

  - `legacy: Optional[bool]`

  - `modified_by: Optional[str]`

### Token Update Response

- `class TokenUpdateResponse: …`

  - `id: str`

  - `cf_api_id: str`

  - `created_at: datetime`

  - `modified_at: datetime`

  - `name: str`

  - `created_by: Optional[str]`

  - `enabled: Optional[bool]`

  - `legacy: Optional[bool]`

  - `modified_by: Optional[str]`

### Token Delete Response

- `class TokenDeleteResponse: …`

  - `id: str`

  - `cf_api_id: str`

  - `created_at: datetime`

  - `modified_at: datetime`

  - `name: str`

  - `created_by: Optional[str]`

  - `enabled: Optional[bool]`

  - `legacy: Optional[bool]`

  - `modified_by: Optional[str]`