Assemble

POST

/v1/objects/assemble

curl --request POST \
  --url https://api.cloud.agentums.ru/v1/objects/assemble \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "object_ids": [ "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" ], "sort": "date" }'

• Прод

Сборка нескольких объектов в один PDF новым объектом (Celery).

Все object_ids должны принадлежать владельцу (иначе 404). Разные форматы внутри (pdf/docx/xlsx/pptx/картинки) приводятся к PDF-страницам; неконвертируемые (txt/аудио/видео) пропускаются. Порядок страниц — sort (date|order). Результат появится новым объектом в списке, когда соберётся (как /convert).

Скрытый файл собирается только при разблокированной зоне (X-Hidden-Token): иначе его id — «не найден». Результат создаётся ОБЫЧНЫМ объектом, поэтому без гейта сборка была бы штатным способом вынести содержимое из зоны «Скрытые» мимо PIN.

Authorizations

• bearerAuth

Parameters

Header Parameters

x-hidden-token

Any of:

string

string

null

null

Request Body^required

Media typeapplication/json

AssembleRequest

Сборка выбранных объектов в один PDF. sort: date (по created_at) или order (порядок переданного списка).

object

name

Any of:

string

string

<= 255 characters

null

null

object_ids

required

Object Ids

Array<string>

>= 1 items <= 200 items

sort

Sort

string

default: date

Allowed values: date order

Responses

202

Successful Response

Media typeapplication/json

AssembleAccepted

Сборка принята: результат появится НОВЫМ объектом-PDF в списке (Celery).

object

count

Count

integer

0

status

Status

string

default: accepted

Example

{
  "count": 0,
  "status": "accepted"
}

422

Validation Error

Media typeapplication/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

ctx

Context

object

input

Input

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

Example^generated

{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}