---
title: "Create asset in Pics.io"
method: POST
path: "/images"
tags: ["Assets"]
---

# Create asset in Pics.io

`POST /images`

## Request

- Base URL: `https://api.pics.io`
- URL: `https://api.pics.io/images`
- Auth: HTTP bearer

## Request body

- object
  - `additionalFields` object, required
    - `assigneeIds` string[]
    - `keywordsIds` string[]
    - `color` 'red' | 'yellow' | 'green' | 'blue' | 'purple' | 'nocolor'
    - `comment` string
    - `rating` number
    - `title` string
    - `description` string
    - `flag` 'rejected' | 'unflagged' | 'flagged'
  - `assetData` object, required: All data that returns in response while upload file + storageId
    - `storageId` string: id field that returns in response while upload file
    - `name` string
    - `fileSize` number
    - `tags` object[]
      - `_id` string: collection id to attach

## Response `200`

Ok

- unknown

---

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