Skip to main content
POST
Create a medium from an upload

Authorizations

Authorization
string
header
required

A member credential in the Authorization: Bearer header: a member session JWT, a portal JWT whose login is linked to a membership in that company, or an opaque member token. The credential alone identifies the member and company.

Body

application/json

The upload to consume and the medium's details.

upload_id
string<uuid>
required

The upload_id from POST /media/uploads.

title
string
required

Title containing at least one non-whitespace character.

Required string length: 1 - 255
Pattern: ^[^\u0000]*[^\u0000\u0009-\u000D\u0020\u0085\u00A0\u1680\u2000-\u200A\u2028\u2029\u202F\u205F\u3000][^\u0000]*$
description
string | null

Plain-text description.

Maximum string length: 5000
Pattern: ^[^\u0000]*$
tags
string[]

Names of existing company medium tags.

Maximum string length: 255
Pattern: ^[^\u0000]*$

Response

The created medium.

One medium.

status
integer
required

HTTP response status.

data
object
required

A medium the signed-in member uploaded.

meta
object
required

Envelope metadata present on every response.