Create a media folder

POST

/public/v1/media/folders

curl --request POST \
  --url https://api.loomta.com/public/v1/media/folders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "Launch assets" }'

• Production

Authorizations

• apiKey

Request Body^required

Media typeapplication/json

object

name

required

string

>= 1 characters <= 255 characters

Example

{
  "name": "Launch assets"
}

Responses

201

The created folder.

Media typeapplication/json

object

id

string format: uuid

organizationId

string format: uuid

name

string

createdAt

string format: date-time

updatedAt

string format: date-time

Example^generated

{
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "organizationId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "name": "example",
  "createdAt": "2026-04-15T12:00:00Z",
  "updatedAt": "2026-04-15T12:00:00Z"
}

400

The request body failed validation.

Media typeapplication/json

object

code

required

A stable, machine-readable error code to branch on.

string

message

required

A human-readable description.

string

details

Optional structured detail (for example Zod validation issues).

Example

{
  "code": "invalid_request",
  "message": "The request payload is invalid.",
  "details": [
    {
      "path": [
        "slideCount"
      ],
      "message": "Number must be greater than or equal to 3"
    }
  ]
}

401

The API key is missing or invalid.

Media typeapplication/json

object

code

required

A stable, machine-readable error code to branch on.

string

message

required

A human-readable description.

string

details

Optional structured detail (for example Zod validation issues).

Examples

{
  "code": "missing_api_key",
  "message": "A Bearer API key is required."
}

{
  "code": "invalid_api_key",
  "message": "The API key is invalid."
}