Create Gallery

Create a gallery.

Use this to create a reusable gallery in your account. Inspect the returned record before continuing the synchronization.

Behaviour

Only the localized name is required; you may also pass the general fields (description, number of columns) and media items to build the whole gallery in one call.

Extras are applied by a follow-up update after the gallery exists; if that step fails the gallery is still created and the response shows it without them.

Requires the galleries:write scope.

post

Authorizations

AuthorizationstringRequired

API key sent as a bearer token (mk_live_… / mk_test_…).

Body

Data schema used by Create Gallery (POST /v1/galleries). Read that operation for usage, permissions and update rules. Required fields and allowed values are defined below; request and response shapes can differ.

numColumnsstring · min: 1Optional

Responses

201

Created.

application/json

400

Invalid request data.

application/json

401

Missing or invalid API key.

application/json

403

The API key lacks the required scope (scope_denied), or the operation is not permitted for this account (operation_not_permitted).

application/json

429

The API key exceeded its request rate (rate_limit_exceeded) or its monthly quota (quota_exceeded). Both carry Retry-After; the RateLimit-* headers accompany rate_limit_exceeded only, since a spent quota says nothing about the bucket.

application/json

500

Internal server error.

application/json

post/v1/galleries

POST /v1/galleries HTTP/1.1
Host: admin.mimeeqapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 345

{
  "name": {
    "en": "Summer Lookbook",
    "de": "Sommer-Lookbook"
  },
  "description": {
    "en": "Spring collection",
    "de": "Frühjahrskollektion"
  },
  "numColumns": "text",
  "items": [
    {
      "id": "text",
      "mediaType": "IMAGE",
      "mediaSource": "CUSTOM",
      "caption": {
        "en": "A caption",
        "de": "Eine Bildunterschrift"
      },
      "fileId": "text",
      "filePath": "text",
      "url": "text",
      "loop": true,
      "autoplay": true
    }
  ]
}

{
  "data": {
    "galleryId": "GALL-123e4567-e89b-12d3-a456-426614174000",
    "name": "Chair",
    "numberOfItems": 1,
    "createdAt": "text",
    "modifiedAt": "text",
    "description": "Chair",
    "numColumns": "text",
    "items": [
      {
        "id": "text",
        "mediaType": "IMAGE",
        "mediaSource": "CUSTOM",
        "caption": "Chair",
        "fileId": "text",
        "filePath": "text",
        "url": "text",
        "loop": true,
        "autoplay": true
      }
    ]
  }
}