---
title: "Create a _media object"
method: POST
path: "/api/v1/content/_media"
tags: ["Content: Media (internal)"]
---

# Create a _media object

`POST /api/v1/content/_media`

## Request

- Base URL: `https://api.flotiq.com`
- URL: `https://api.flotiq.com/api/v1/content/_media`
- Auth: API key in header `X-AUTH-TOKEN`

Allows you to create object of Media (internal) type. <br />

## Request body

- MediaWithoutInternal
  - `id` string, required: Unique ID of the object
  - `alt` string
  - `url` string, required
  - `size` number, required
  - `tags` DataSource[]
    - `dataUrl` string, required
    - `type` 'internal' | 'external', required
  - `type` string, required
  - `title` string
  - `width` number
  - `height` number
  - `source` string, required
  - `fileName` string, required
  - `mimeType` string, required
  - `variants` object[]
    - `name` string, required
    - `trim` object
      - `top` number, required
      - `left` number, required
      - `right` number
      - `width` number
      - `bottom` number
      - `height` number
  - `extension` string, required
  - `externalId` string

## Response `200`

OK

- Media
  - `id` string, required: Unique ID of the object
  - `internal` object: Immutable object containing system information, it will be automatically generated on object creation and regenerated on updates.
    - `contentType` string, required: Name of Content Type Definition of object
    - `createdAt` string, required: Date and time of creation of Content Object, in ISO 8601 date format
    - `updatedAt` string, required: Date and time of last update of Content Object, in ISO 8601 date format
    - `deletedAt` string, required: Date and time of deletion of Content Object, in ISO 8601 date format
    - `workflowState` string: Information about object's current state in workflow
    - `status` string: Information about object's current status. Available states: draft, public, modified
    - `objectTitle` string: Object title
    - `latestVersion` number: Latest version of the Content Object
    - `workflowPublicVersion` number: number of latest published version of Content Object
    - `workflowPublishedAt` string: publication date of latest publish version of Content Object
    - `publishedAt` string: Publication date
    - `scheduledAtTimeZone` string: string with tz timezone name (np. Europe/Warsaw)
    - `publicVersion` number: number of latest published version of Content Object
  - `alt` string
  - `url` string, required
  - `size` number, required
  - `tags` Tag[]
    - `id` string, required: Unique ID of the object
    - `internal` object: Immutable object containing system information, it will be automatically generated on object creation and regenerated on updates.
      - `contentType` string, required: Name of Content Type Definition of object
      - `createdAt` string, required: Date and time of creation of Content Object, in ISO 8601 date format
      - `updatedAt` string, required: Date and time of last update of Content Object, in ISO 8601 date format
      - `deletedAt` string, required: Date and time of deletion of Content Object, in ISO 8601 date format
      - `workflowState` string: Information about object's current state in workflow
      - `status` string: Information about object's current status. Available states: draft, public, modified
      - `objectTitle` string: Object title
      - `latestVersion` number: Latest version of the Content Object
      - `workflowPublicVersion` number: number of latest published version of Content Object
      - `workflowPublishedAt` string: publication date of latest publish version of Content Object
      - `publishedAt` string: Publication date
      - `scheduledAtTimeZone` string: string with tz timezone name (np. Europe/Warsaw)
      - `publicVersion` number: number of latest published version of Content Object
    - `name` string, required
  - `type` string, required
  - `title` string
  - `width` number
  - `height` number
  - `source` string, required
  - `fileName` string, required
  - `mimeType` string, required
  - `variants` object[]
    - `name` string, required
    - `trim` object
      - `top` number, required
      - `left` number, required
      - `right` number
      - `width` number
      - `bottom` number
      - `height` number
  - `extension` string, required
  - `externalId` string

## Other responses

- `400`: Validation error
- `401`: Unauthorized
- `403`: Access denied or quota limit exceeded
- `404`: Not found

---

[API](https://skmtc.dev/flotiq/apis/flotiq-user-api.md) · [All operations](https://skmtc.dev/flotiq/apis/flotiq-user-api/llms.txt) · [OpenAPI document](https://skmtc.dev/flotiq/apis/flotiq-user-api/revisions/7237c4268052?raw)