Structured response bodyBody structurat al răspunsului
application/json
Structured response bodyBody structurat al răspunsului
Complete response schemaSchema completă a răspunsului
{
"$ref": "#/components/schemas/ExecutionList",
"type": "object",
"additionalProperties": false,
"required": [
"executions"
],
"properties": {
"executions": {
"type": "array",
"maxItems": 100,
"items": {
"$ref": "#/components/schemas/Execution",
"type": "object",
"additionalProperties": false,
"required": [
"id",
"release_id",
"release_hash",
"processing_kind",
"input_hash",
"raw_input_hash",
"status",
"submitted_by",
"correlation_id",
"created_at",
"updated_at",
"steps",
"artifacts"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"release_id": {
"type": "string",
"format": "uuid"
},
"release_hash": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"processing_kind": {
"type": "string",
"enum": [
"transformation",
"document_generation"
]
},
"submission_id": {
"type": "string",
"format": "uuid"
},
"processing_node_id": {
"type": "string",
"format": "uuid"
},
"input": {
"x-docula-max-bytes": 524288
},
"input_hash": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"raw_input": {
"type": "string",
"minLength": 1,
"x-docula-max-bytes": 524288
},
"raw_input_hash": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"metadata": {
"$ref": "#/components/schemas/IntakeMetadata",
"type": "object",
"additionalProperties": false,
"required": [
"schema",
"source_object",
"source_timestamp",
"source_actor",
"source_system",
"fixture_family",
"scenario_id",
"schedule_interval_months"
],
"properties": {
"schema": {
"type": "string",
"const": "docula-intake-metadata-v1"
},
"source_object": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"
},
"source_timestamp": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"source_actor": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._:@+-]{0,127}$"
},
"source_system": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._-]{0,63}$"
},
"fixture_family": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._-]{0,63}$"
},
"scenario_id": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9._-]{0,63}$"
},
"schedule_interval_months": {
"type": "integer",
"enum": [
1,
6,
12
]
}
}
},
"output": {
"x-docula-max-bytes": 524288
},
"output_hash": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"status": {
"type": "string",
"enum": [
"queued",
"processing",
"awaiting_compose",
"completed",
"failed"
]
},
"submitted_by": {
"type": "string",
"format": "uuid"
},
"correlation_id": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"completed_at": {
"type": "string",
"format": "date-time"
},
"steps": {
"type": "array",
"minItems": 2,
"maxItems": 4,
"items": {
"$ref": "#/components/schemas/ExecutionStep",
"type": "object",
"additionalProperties": false,
"required": [
"name",
"position",
"status",
"attempt",
"state_version"
],
"properties": {
"name": {
"type": "string",
"enum": [
"validate",
"transform.declarative",
"compose",
"render"
]
},
"position": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"status": {
"type": "string",
"enum": [
"not_started",
"queued",
"running",
"succeeded",
"failed"
]
},
"attempt": {
"type": "integer",
"minimum": 0,
"maximum": 5
},
"state_version": {
"type": "integer",
"minimum": 1
},
"started_at": {
"type": "string",
"format": "date-time"
},
"finished_at": {
"type": "string",
"format": "date-time"
},
"duration_ms": {
"type": "integer",
"minimum": 0
},
"summary": {
"type": "object"
},
"failure": {
"$ref": "#/components/schemas/ExecutionFailure",
"type": "object",
"additionalProperties": false,
"required": [
"code",
"message",
"issues"
],
"properties": {
"code": {
"type": "string",
"pattern": "^[a-z][a-z0-9_.-]{0,63}$"
},
"message": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"issues": {
"type": "array",
"maxItems": 20,
"items": {
"$ref": "#/components/schemas/ExecutionIssue",
"type": "object",
"additionalProperties": false,
"required": [
"path",
"message"
],
"properties": {
"path": {
"type": "string",
"maxLength": 512
},
"keyword": {
"type": "string",
"maxLength": 64
},
"message": {
"type": "string",
"minLength": 1,
"maxLength": 240
}
}
}
}
}
}
}
}
},
"artifacts": {
"type": "array",
"maxItems": 2,
"items": {
"$ref": "#/components/schemas/ExecutionArtifact",
"type": "object",
"additionalProperties": false,
"required": [
"id",
"kind",
"media_type",
"byte_size",
"content_hash",
"created_at"
],
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"kind": {
"type": "string",
"enum": [
"docx",
"pdf"
]
},
"media_type": {
"type": "string",
"enum": [
"application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"application/pdf"
]
},
"byte_size": {
"type": "integer",
"minimum": 1,
"maximum": 26214400
},
"content_hash": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"created_at": {
"type": "string",
"format": "date-time"
}
}
}
}
}
}
},
"next_cursor": {
"type": "string",
"format": "uuid"
}
}
}{
"executions": [
{
"id": "11111111-1111-4111-8111-000000000001",
"release_id": "11111111-1111-4111-8111-000000000001",
"release_hash": "0000000000000000000000000000000000000000000000000000000000000000",
"processing_kind": "transformation",
"input_hash": "0000000000000000000000000000000000000000000000000000000000000000",
"raw_input_hash": "0000000000000000000000000000000000000000000000000000000000000000",
"status": "queued",
"submitted_by": "11111111-1111-4111-8111-000000000001",
"correlation_id": "11111111-1111-4111-8111-000000000001",
"created_at": "2026-08-01T10:00:00Z",
"updated_at": "2026-08-01T10:00:00Z",
"steps": [
{
"name": "validate",
"position": 1,
"status": "not_started",
"attempt": 0,
"state_version": 1
},
{
"name": "transform.declarative",
"position": 2,
"status": "queued",
"attempt": 1,
"state_version": 2
}
],
"artifacts": []
}
]
}