List successful canonical artifacts through a PostgreSQL projectionListează artefactele canonice reușite din proiecția PostgreSQL

Requires submission_read. Results are ordered by (created_at DESC, artifact_id DESC), use a filter-bound opaque cursor, and never scan S3 or expose object keys. Artifact download independently requires artifact_download.Necesită submission_read, folosește un cursor opac legat de filtre și nu expune cheile obiectelor din S3.

Roles: administrator, engineer, operator, auditor, business_viewerRoluri: administrator (administrator), engineer (inginer), operator (operator), auditor (auditor), business_viewer (cititor business)Host-local session requiredEste necesară sesiunea hostului

A session with must_change_password=true is forbidden regardless of role; only session read, password change, and logout remain authorized.O sesiune cu must_change_password=true este interzisă indiferent de rol; rămân autorizate doar citirea sesiunii, schimbarea parolei și deconectarea.

Required headers and parametersHeadere și parametri obligatorii

fromquery · optionalopțional
Inclusive artifact created_at UTC boundary; defaults to 30 days before to.Limita UTC inclusivă pentru received_at; implicit este cu 30 de zile înainte de to.
2026-08-01T10:00:00Z

Complete parameter schemaSchema completă a parametrului

{
  "type": "string",
  "format": "date-time"
}

toquery · optionalopțional
Exclusive artifact created_at UTC boundary; defaults to now and permits at most 366 days.Limita UTC exclusivă pentru received_at; implicit este momentul curent și permite un interval de cel mult 366 de zile.
2026-08-01T10:00:00Z

Complete parameter schemaSchema completă a parametrului

{
  "type": "string",
  "format": "date-time"
}

object_referencequery · optionalopțional
Exact Submission object reference.Filtrul exact după referința obiectului clientului.
DOCS-EXAMPLE-0001

Complete parameter schemaSchema completă a parametrului

{
  "type": "string",
  "minLength": 1,
  "maxLength": 128,
  "pattern": "^[A-Za-z0-9][A-Za-z0-9._:@+-]{0,127}$"
}

model_slugquery · optionalopțional
Exact ingestion model slug.Slugul exact al modelului de ingestie.
synthetic-example

Complete parameter schemaSchema completă a parametrului

{
  "type": "string",
  "minLength": 1,
  "maxLength": 64,
  "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$"
}

producing_node_addressquery · optionalopțional
Exact recursive business node address.Adresa recursivă exactă a nodului business.
document:render

Complete parameter schemaSchema completă a parametrului

{
  "type": "string",
  "minLength": 3,
  "maxLength": 1024,
  "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*(?::[a-z0-9]+(?:-[a-z0-9]+)*){1,15}$"
}

formatquery · optionalopțional
Exact retained artifact format.Formatul exact al artefactului păstrat.
docx

Complete parameter schemaSchema completă a parametrului

{
  "type": "string",
  "enum": [
    "docx",
    "pdf"
  ]
}

limitquery · optionalopțional
Maximum number of ordered results to return on this page.Numărul maxim de rezultate ordonate returnate în această pagină.
25

Complete parameter schemaSchema completă a parametrului

{
  "type": "integer",
  "minimum": 1,
  "maximum": 100,
  "default": 25
}

cursorquery · optionalopțional
Opaque cursor binding the normalized UTC window and every Storage filter.Cursor stabil și opac din pagina ordonată precedentă; păstrează filtrele operației la continuare.
synthetic-cursor

Complete parameter schemaSchema completă a parametrului

{
  "type": "string",
  "minLength": 1,
  "maxLength": 512
}

Parameter limitsLimitele parametrilor

{"name":"object_reference","maximum":null,"max_length":128}{"name":"model_slug","maximum":null,"max_length":64}{"name":"producing_node_address","maximum":null,"max_length":1024}{"name":"limit","maximum":100,"max_length":null}{"name":"cursor","maximum":null,"max_length":512}

Lifecycle and conventionsCiclu și convenții

Request examplesExemple de cerere

Synthetic curl · copy onlycurl sintetic · numai pentru copiere

curl --request GET "$DOCULA_URL/api/v1/storage" \
  --cookie "$COOKIE_JAR"

No request body applies. Use the documented method, path, headers, and parameters.Nu se aplică un body al cererii. Folosește metoda, calea, headerele și parametrii documentați.

Responses and failuresRăspunsuri și erori

200A stable newest-first bounded PostgreSQL projection of successful retained artifacts.O proiecție PostgreSQL stabilă și mărginită a artefactelor reușite păstrate, ordonată de la cel mai nou.