---
title: "POST /usage/files"
method: POST
path: "/usage/files"
tags: ["Usage Reporting"]
---

# POST /usage/files

`POST /usage/files`

UsageFile collection contains APIs which can used used to create
Usage report, upload normalized file
and other actions available for vendors and providers.

## Request body

- object
  - `name` string
  - `description` string
  - `note` string
  - `period` object
    - `from` string, date
    - `to` string, date
  - `currency` string
  - `product` object
    - `id` string
  - `contract` object
    - `id` string
  - `external_id` string

## Response `201`

- UsageUsageFileCreate
  - `id` string
  - `name` string, nullable
  - `external_id` string
  - `vendor` string, nullable
  - `provider` string, nullable
  - `environment` 'test' | 'preview' | 'production'
  - `marketplace` string, nullable
  - `distribution_contract` string, nullable
  - `product_id` string, nullable
  - `product_name` string, nullable
  - `product_icon` string
  - `description` string, nullable
  - `schema` 'tr' | 'pr' | 'qt' | 'cr'
  - `currency` string
  - `start_datetime_utc` string, date-time, nullable
  - `end_datetime_utc` string, date-time, nullable

## Other responses

- `400`

---

[API](https://skmtc.net/cloudblue/apis/cloudblue-connect-api.md) · [All operations](https://skmtc.net/cloudblue/apis/cloudblue-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cloudblue/cloudblue-connect-api/revisions/0421d2a97c52/schema)