Content Save Status

GET

/v1/objects/content-status/{task_id}

curl --request GET \
  --url https://api.cloud.agentums.ru/v1/objects/content-status/example \
  --header 'Authorization: Bearer <token>'

• Прод

Статус пересборки docx/pdf по task_id: SUCCESS → id/имя обновлённого объекта. Открытие файла всё равно проверяет владельца — по task_id утечки доступа нет.

error='version_conflict' — задача отработала, но правку НЕ применила: файл успели изменить в другом сеансе (тот же смысл, что 412 у синхронного пути).

Authorizations

• bearerAuth

Parameters

Path Parameters

task_id

required

Task Id

string

Responses

200

Successful Response

Media typeapplication/json

ContentSaveStatus

Статус фоновой пересборки docx/pdf. error — терминальная причина отказа задачи (version_conflict — файл успели изменить в другом сеансе, правка НЕ применена); при нём object_id пуст, и клиент обязан показать конфликт, а не «сохранено».

object

done

Done

boolean

error

Error

string

""

filename

Filename

string

""

object_id

Any of:

string

string format: uuid

null

null

state

required

State

string

Example

{
  "done": false,
  "error": "",
  "filename": ""
}

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"
    }
  ]
}