# Assets

## Upsert asset hashes

`pages.assets.upsert_hashes(AssetUpsertHashesParams**kwargs)  -> AssetUpsertHashesResponse`

**post** `/pages/assets/upsert-hashes`

Register the provided file hashes as recently uploaded to the Pages
asset store. Used as part of the Pages Direct Upload workflow so future
deployments can avoid re-uploading files that are already present.

Authenticate with the JWT obtained from the upload-token endpoint:
GET /accounts/{account_id}/pages/projects/{project_name}/upload-token

### Parameters

- `hashes: Sequence[str]`

  List of file content hashes to register in the asset store.

### Returns

- `class AssetUpsertHashesResponse: …`

  - `errors: List[Error]`

    - `code: int`

    - `message: str`

    - `documentation_url: Optional[str]`

    - `source: Optional[ErrorSource]`

      - `pointer: Optional[str]`

  - `messages: List[Message]`

    - `code: int`

    - `message: str`

    - `documentation_url: Optional[str]`

    - `source: Optional[MessageSource]`

      - `pointer: Optional[str]`

  - `success: Literal[true]`

    Whether the API call was successful.

    - `true`

### Example

```python
from cloudflare import Cloudflare

client = Cloudflare()
response = client.pages.assets.upsert_hashes(
    hashes=["a948904f2f0f479b8f936b8a0c5d9882", "b026324c6904b2a9cb4b88d6d61c81d1"],
)
print(response.errors)
```

#### Response

```json
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true
}
```

## Check missing assets

`pages.assets.check_missing(AssetCheckMissingParams**kwargs)  -> SyncSinglePage[AssetCheckMissingResponse]`

**post** `/pages/assets/check-missing`

Check which of the provided file hashes are missing from the Pages
asset store. Returns a list of missing hashes that need to be uploaded.
Used as part of the Pages Direct Upload workflow.

Authenticate with the JWT obtained from the upload-token endpoint:
GET /accounts/{account_id}/pages/projects/{project_name}/upload-token

### Parameters

- `hashes: Sequence[str]`

  List of file content hashes to check for existence in the asset store.

### Returns

- `str`

### Example

```python
from cloudflare import Cloudflare

client = Cloudflare()
page = client.pages.assets.check_missing(
    hashes=["a948904f2f0f479b8f936b8a0c5d9882", "b026324c6904b2a9cb4b88d6d61c81d1"],
)
page = page.result[0]
print(page)
```

#### Response

```json
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "result": [
    "b026324c6904b2a9cb4b88d6d61c81d1"
  ],
  "success": true
}
```

## Upload asset

`pages.assets.upload(AssetUploadParams**kwargs)  -> AssetUploadResponse`

**post** `/pages/assets/upload`

Upload one or more files to the Pages asset store. Each file is
identified by its content hash and is uploaded using the same JSON shape
as the Cloudflare KV bulk write API. Used as part of the Pages Direct
Upload workflow.

Authenticate with the JWT obtained from the upload-token endpoint:
GET /accounts/{account_id}/pages/projects/{project_name}/upload-token

### Parameters

- `body: Iterable[Body]`

  - `base64: bool`

    Whether value is base64 encoded.

  - `key: str`

    File content hash used as the object key in the Pages asset store.

  - `metadata: BodyMetadata`

    - `content_type: str`

      MIME type for the uploaded file.

  - `value: str`

    File content. When base64 is true, this value is base64 encoded.

### Returns

- `class AssetUploadResponse: …`

  - `errors: List[Error]`

    - `code: int`

    - `message: str`

    - `documentation_url: Optional[str]`

    - `source: Optional[ErrorSource]`

      - `pointer: Optional[str]`

  - `messages: List[Message]`

    - `code: int`

    - `message: str`

    - `documentation_url: Optional[str]`

    - `source: Optional[MessageSource]`

      - `pointer: Optional[str]`

  - `success: Literal[true]`

    Whether the API call was successful.

    - `true`

### Example

```python
from cloudflare import Cloudflare

client = Cloudflare()
response = client.pages.assets.upload(
    body=[{
        "base64": True,
        "key": "b026324c6904b2a9cb4b88d6d61c81d1",
        "metadata": {
            "content_type": "text/plain"
        },
        "value": "SGVsbG8sIFdvcmxkIQ==",
    }],
)
print(response.errors)
```

#### Response

```json
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true
}
```

## Domain Types

### Asset Upsert Hashes Response

- `class AssetUpsertHashesResponse: …`

  - `errors: List[Error]`

    - `code: int`

    - `message: str`

    - `documentation_url: Optional[str]`

    - `source: Optional[ErrorSource]`

      - `pointer: Optional[str]`

  - `messages: List[Message]`

    - `code: int`

    - `message: str`

    - `documentation_url: Optional[str]`

    - `source: Optional[MessageSource]`

      - `pointer: Optional[str]`

  - `success: Literal[true]`

    Whether the API call was successful.

    - `true`

### Asset Check Missing Response

- `str`

### Asset Upload Response

- `class AssetUploadResponse: …`

  - `errors: List[Error]`

    - `code: int`

    - `message: str`

    - `documentation_url: Optional[str]`

    - `source: Optional[ErrorSource]`

      - `pointer: Optional[str]`

  - `messages: List[Message]`

    - `code: int`

    - `message: str`

    - `documentation_url: Optional[str]`

    - `source: Optional[MessageSource]`

      - `pointer: Optional[str]`

  - `success: Literal[true]`

    Whether the API call was successful.

    - `true`