---
title: "Create an asset"
method: POST
path: "/assets/v1/assets"
tags: ["Assets"]
---

# Create an asset

`POST /assets/v1/assets`

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/assets/v1/assets`
- Auth: HTTP bearer

## Request body

- S12AssetsV1CreateAssetRequest: The parameters for `CreateAsset`
  - `code` string, required: Customer specified identifier for the asset. Unique per org.
  - `fields` S12AssetsV1AssetField[]: List of fields based on the type of asset.
    - `name` string: The name of an asset field.
    - `string_value` string: The string value of an asset field. This attribute is only used for asset fields using the FIELD_VALUE_TYPE_STRING type.
    - `money_value` S12CommonMoney: Represents an amount of money with its currency type.
      - `currency_code` string: The 3-letter currency code defined in ISO 4217.
      - `units` string, int64: The whole units of the amount. For example if `currencyCode` is `"USD"`, then 1 unit is one US dollar.
      - `nanos` integer: Number of nano (10^-9) units of the amount. The value must be between -999,999,999 and +999,999,999 inclusive. If `units` is positive, `nanos` must be positive or zero. If `units` is zero, `nanos` can be positive, zero, or negative. If `units` is negative, `nanos` must be negative or zero. For example £-1.75 is represented as `units`=-1 and `nanos`=-750,000,000.
    - `timestamp_value` string, date-time: The timestamp value of an asset field. This attribute is only used for asset fields using the FIELD_VALUE_TYPE_TIMESTAMP type.
    - `field_id` string: The unique identifier of an asset field. This ID is system-generated.
  - `site` string: Unique ID of site to be associated with asset.
  - `profile_image` S12AssetsV1AssetMedia: This object is used to define media object associated with an asset, including profile image, photos and documents.
    - `media_id` string: ID of media.
    - `media_type` 'MEDIA_TYPE_IMAGE' | 'MEDIA_TYPE_VIDEO' | 'MEDIA_TYPE_PDF' | 'MEDIA_TYPE_DOCX' | 'MEDIA_TYPE_XLSX' | 'MEDIA_TYPE_PPTX' | 'MEDIA_TYPE_CSV': - MEDIA_TYPE_IMAGE: An image file (GIF, JPG, PNG, WEBP). - MEDIA_TYPE_VIDEO: A video file (MP4, MOV). - MEDIA_TYPE_PDF: A PDF document. - MEDIA_TYPE_DOCX: A Microsoft Word document (DOCX, DOC). - MEDIA_TYPE_XLSX: A Microsoft Excel spreadsheet (XLSX, XLS). - MEDIA_TYPE_PPTX: A Microsoft PowerPoint presentation (PPTX, PPT). - MEDIA_TYPE_CSV: A CSV file.
    - `filename` string: Full file name including extension.
  - `type_id` string, required: Global unique identifier of the asset type.
  - `status_option_ids` string[]: ID of the status option to assign. Each entry must belong to the status group associated with the asset type. You can only add one entry.

## Response `200`

A successful response.

- S12AssetsV1CreateAssetResponse: Result returned from `CreateAsset`
  - `id` string: The identifier of the created asset.

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/safetyculture/apis/safetyculture-api.md) - [All operations](https://skmtc.dev/safetyculture/apis/safetyculture-api/llms.txt) - [OpenAPI document](https://skmtc.dev/safetyculture/apis/safetyculture-api/revisions/eb6bb843bf18?raw)
