{"components":{"schemas":{"Analysis":{"properties":{"analysis_type":{"description":"Configured analysis workflow type.","type":"string"},"annotation_comment_count":{"description":"Number of address comments produced by the analysis.","type":["integer","null"]},"annotation_rename_count":{"description":"Number of symbol or variable renames produced by the analysis.","type":["integer","null"]},"completed_at":{"description":"UTC timestamp when processing ended, or null while unfinished.","format":"date-time","type":["string","null"]},"cost_credits":{"description":"Inference cost charged for the analysis in credits, when available.","minimum":0,"type":["number","null"]},"created_at":{"description":"UTC timestamp when the analysis record was created.","format":"date-time","type":"string"},"detection":{"description":"Aggregate detection category, or `unknown` when no verdict is available.","type":"string"},"detection_confidence":{"description":"Aggregate detection confidence percentage, when available.","type":["integer","null"]},"elapsed_seconds":{"description":"Measured analysis duration in seconds, when available.","minimum":0,"type":["number","null"]},"id":{"description":"Unique analysis identifier.","type":"integer"},"model":{"description":"Inference model actually used, or null before one is recorded.","type":["string","null"]},"result_count":{"description":"Number of result messages received from workers, when available.","type":["integer","null"]},"result_success":{"description":"Success flag reported by the completed worker result, when available.","type":["boolean","null"]},"root_file":{"$ref":"#/components/schemas/RootFile","description":"Identity and type information for the submitted root sample."},"started_at":{"description":"UTC timestamp when processing started, or null before execution.","format":"date-time","type":["string","null"]},"status":{"description":"Current analysis lifecycle state.","type":"string"},"success":{"description":"True after completion, false after failure, or null while the analysis is pending or running.","type":["boolean","null"]},"task_type":{"description":"Semantic task executed by the analysis worker.","enum":["triage","behavior","unpack","config"],"type":"string"}},"required":["id","analysis_type","task_type","status","success","result_success","result_count","annotation_rename_count","annotation_comment_count","detection","detection_confidence","root_file","created_at","started_at","completed_at","elapsed_seconds","cost_credits","model"],"type":"object"},"AnalysisOutputs":{"properties":{"analysis_id":{"description":"Unique identifier of the owning analysis.","type":"integer"},"annotations":{"$ref":"#/components/schemas/OutputResource","description":"Availability, counts, and URL of recovered renames and comments."},"artifacts":{"$ref":"#/components/schemas/OutputResource","description":"Availability, count, and URL of retained returned files."},"chat":{"$ref":"#/components/schemas/OutputResource","description":"Availability and download URL of the stored AI chat JSON log."},"configuration":{"$ref":"#/components/schemas/OutputResource","description":"Availability, entry count, and URL of extracted configuration data."},"detections":{"$ref":"#/components/schemas/OutputResource","description":"Availability, family count, and URL of Kesakode detections."},"file_tree":{"$ref":"#/components/schemas/OutputResource","description":"Availability, entry count, and URL of recursive file relationships."},"report":{"$ref":"#/components/schemas/OutputResource","description":"Availability and download URL of the AI report."},"status":{"description":"Current analysis lifecycle state.","type":"string"},"technical_reports":{"$ref":"#/components/schemas/OutputResource","description":"Availability, count, and URL of static-analysis reports."}},"required":["analysis_id","status","report","chat","artifacts","configuration","annotations","technical_reports","file_tree","detections"],"type":"object"},"AnalysisSearchResults":{"properties":{"analyses":{"description":"Owned analyses matching every supplied search filter.","items":{"$ref":"#/components/schemas/Analysis"},"type":"array"},"count":{"description":"Number of analyses returned in this page.","minimum":0,"type":"integer"},"has_more":{"description":"Whether another page of matching analyses is available.","type":"boolean"},"limit":{"description":"Maximum number of analyses requested for this page.","maximum":100,"minimum":1,"type":"integer"},"offset":{"description":"Number of matching analyses skipped before this page.","minimum":0,"type":"integer"}},"required":["analyses","count","limit","offset","has_more"],"type":"object"},"AnalysisStatus":{"properties":{"id":{"description":"Unique analysis identifier.","type":"integer"},"status":{"description":"Current analysis lifecycle state.","type":"string"},"success":{"description":"True after completion, false after failure, or null while the analysis is pending or running.","type":["boolean","null"]}},"required":["id","status","success"],"type":"object"},"AnalysisSubmission":{"properties":{"analyses":{"description":"Analyses queued for the selected models.","items":{"$ref":"#/components/schemas/SubmittedAnalysis"},"type":"array"},"count":{"description":"Number of analyses queued by this submission.","minimum":1,"type":"integer"},"file":{"$ref":"#/components/schemas/SubmittedFile","description":"Identity of the uploaded root file."}},"required":["file","analyses","count"],"type":"object"},"AnnotatedBundle":{"properties":{"download_url":{"description":"Account-scoped URL for downloading the annotated bundle.","type":"string"},"filename":{"description":"Descriptive filename of the annotated Malcat bundle.","type":"string"},"sha256":{"description":"Lowercase SHA-256 digest of the annotated bundle.","pattern":"^[0-9a-f]{64}$","type":"string"}},"required":["filename","sha256","download_url"],"type":"object"},"Annotation":{"properties":{"analysis_id":{"description":"Internal Malcat analysis identifier for the annotated file.","type":["integer","null"]},"annotated_bundle":{"anyOf":[{"$ref":"#/components/schemas/AnnotatedBundle"},{"type":"null"}],"description":"Downloadable annotated Malcat bundle, or null when no bundle was retained."},"comments":{"description":"Address comments produced by the analysis.","items":{"properties":{"address":{"description":"Start address associated with the comment.","type":"string"},"region_size":{"description":"Number of bytes covered by the comment region.","minimum":0,"type":"integer"},"text":{"description":"Comment text produced by the analysis.","type":"string"}},"required":["address","text","region_size"],"type":"object"},"type":"array"},"download_url":{"description":"Account-scoped source-file download URL, or null when the file was not retained.","type":["string","null"]},"filename":{"description":"Name of the annotated file.","type":"string"},"renames":{"description":"Symbols or variables renamed by the analysis.","items":{"properties":{"address":{"description":"Address of the renamed symbol or variable.","type":"string"},"name":{"description":"Name assigned by the analysis.","type":"string"}},"required":["address","name"],"type":"object"},"type":"array"},"sha256":{"description":"SHA-256 digest of the annotated file.","type":"string"}},"required":["analysis_id","filename","sha256","download_url","renames","comments","annotated_bundle"],"type":"object"},"Artifact":{"properties":{"analysis_id":{"description":"Internal Malcat analysis identifier, when the returned file was analysed.","type":["integer","null"]},"architecture":{"description":"Processor architecture identified for the object.","type":"string"},"download_url":{"description":"Account-scoped URL for downloading the retained object.","type":"string"},"file_category":{"description":"Broad file category identified by static analysis.","type":"string"},"file_type":{"description":"File format identified by static analysis.","type":"string"},"filename":{"description":"Descriptive filename assigned to the retained object.","type":"string"},"kesakode":{"description":"Kesakode family detections for this object.","items":{"$ref":"#/components/schemas/Detection"},"type":"array"},"sha256":{"description":"Lowercase SHA-256 digest of the retained object.","pattern":"^[0-9a-f]{64}$","type":"string"},"size":{"description":"Retained object size in bytes.","minimum":0,"type":"integer"},"warning":{"description":"Retention or processing warning, or null when none was recorded.","type":["string","null"]}},"required":["analysis_id","filename","sha256","size","file_type","file_category","architecture","kesakode","warning","download_url"],"type":"object"},"Detection":{"properties":{"family":{"description":"Detected malware or library family name.","type":"string"},"score":{"description":"Kesakode confidence score from 0 to 100.","maximum":100,"minimum":0,"type":"number"}},"required":["family","score"],"type":"object"},"Detections":{"properties":{"aggregate":{"description":"Job-wide normalized Kesakode detections.","items":{"$ref":"#/components/schemas/Detection"},"type":"array"},"files":{"description":"Detections grouped by analysed or retained file.","items":{"$ref":"#/components/schemas/FileDetections"},"type":"array"}},"required":["aggregate","files"],"type":"object"},"Error":{"properties":{"error":{"description":"Human-readable summary of the request failure.","type":"string"},"fields":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"description":"Validation messages grouped by submitted field name.","type":"object"}},"required":["error"],"type":"object"},"FileDetections":{"properties":{"analysis_id":{"description":"Internal Malcat analysis identifier, when available.","type":["integer","null"]},"detections":{"description":"Normalized Kesakode detections for this file.","items":{"$ref":"#/components/schemas/Detection"},"type":"array"},"filename":{"description":"Name of the file associated with these detections.","type":"string"},"sha256":{"description":"SHA-256 digest of the detected file.","type":"string"}},"required":["analysis_id","filename","sha256","detections"],"type":"object"},"OutputResource":{"properties":{"available":{"description":"Whether this output currently contains retrievable data.","type":"boolean"},"comments":{"description":"Number of recovered address comments.","minimum":0,"type":"integer"},"count":{"description":"Number of entries exposed by this output, when applicable.","minimum":0,"type":"integer"},"renames":{"description":"Number of recovered symbol or variable renames.","minimum":0,"type":"integer"},"url":{"description":"Account-scoped API URL for retrieving this output.","type":"string"}},"required":["available","url"],"type":"object"},"RootFile":{"properties":{"filename":{"description":"Sanitized filename of the analysis root sample.","type":"string"},"sha256":{"description":"Lowercase SHA-256 digest of the root sample.","pattern":"^[0-9a-f]{64}$","type":"string"},"size":{"description":"Root sample size in bytes.","minimum":0,"type":"integer"},"type":{"description":"File type summary identified for the root sample.","type":"string"}},"required":["filename","size","sha256","type"],"type":"object"},"SubmittedAnalysis":{"properties":{"analysis_type":{"description":"Configured analysis workflow type.","type":"string"},"id":{"description":"Unique identifier assigned to the queued analysis.","type":"integer"},"requested_model":{"description":"Configured inference model requested for this analysis.","type":"string"},"status":{"description":"Initial lifecycle state of the queued analysis.","type":"string"},"task_type":{"description":"Semantic task requested from the analysis worker.","type":"string"}},"required":["id","status","analysis_type","task_type","requested_model"],"type":"object"},"SubmittedFile":{"properties":{"filename":{"description":"Sanitized name retained for the submitted file.","type":"string"},"sha256":{"description":"Lowercase SHA-256 digest of the submitted file.","pattern":"^[0-9a-f]{64}$","type":"string"},"size":{"description":"Submitted file size in bytes.","minimum":0,"type":"integer"}},"required":["filename","size","sha256"],"type":"object"},"TechnicalReport":{"properties":{"analysis_id":{"description":"Internal Malcat analysis identifier for the analysed object.","type":"integer"},"report":{"additionalProperties":true,"description":"Complete structured static-analysis report.","type":"object"},"source":{"description":"How the analysed object entered the analysis workflow.","type":"string"},"statistics":{"additionalProperties":true,"description":"Statistics recorded while producing the technical report.","type":"object"},"tool_name":{"description":"Tool that produced the object, or null for the root sample.","type":["string","null"]}},"required":["analysis_id","source","tool_name","report","statistics"],"type":"object"},"TechnicalReportSummary":{"properties":{"analysis_id":{"description":"Internal Malcat analysis identifier for the analysed object.","type":"integer"},"architecture":{"description":"Processor architecture identified for the object.","type":"string"},"file_category":{"description":"Broad file category identified by static analysis.","type":"string"},"file_type":{"description":"File format identified by static analysis.","type":"string"},"filename":{"description":"Filename recorded in the static-analysis report.","type":"string"},"sha256":{"description":"SHA-256 digest recorded in the static-analysis report.","type":"string"},"source":{"description":"How the analysed object entered the analysis workflow.","type":"string"},"tool_name":{"description":"Tool that produced the object, or null for the root sample.","type":["string","null"]},"url":{"description":"Account-scoped URL of the complete technical report.","type":"string"}},"required":["analysis_id","source","tool_name","filename","sha256","file_type","file_category","architecture","url"],"type":"object"}},"securitySchemes":{"ApiKeyAuth":{"description":"API key sent directly in the `X-API-Key` header.","in":"header","name":"X-API-Key","type":"apiKey"},"BearerAuth":{"description":"API key sent as `Authorization: Bearer <key>`.","scheme":"bearer","type":"http"}}},"info":{"description":"Submit samples and retrieve analysis results owned by your Malcat Logos account. Select **Authorize** to supply either a bearer API key or the `X-API-Key` header. Paths and methods are generated from Flask's registered routes; endpoint metadata and schemas live beside the route implementations in `api.py`.","title":"Malcat Logos API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/analysis/search":{"get":{"description":"Find analyses owned by the authenticated account. At least one exact SHA-256, filename, or analysis type filter is required; supplied filters are combined.","operationId":"analysis_search","parameters":[{"description":"Exact root-file SHA-256 digest.","in":"query","name":"sha256","required":false,"schema":{"pattern":"^[0-9a-fA-F]{64}$","type":"string"}},{"description":"Exact root-file name.","in":"query","name":"filename","required":false,"schema":{"maxLength":255,"type":"string"}},{"description":"Exact analysis type.","in":"query","name":"analysis_type","required":false,"schema":{"maxLength":32,"type":"string"}},{"description":"Maximum number of results.","in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":100,"minimum":1,"type":"integer"}},{"description":"Number of matching results to skip.","in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisSearchResults"}}},"description":"Matching analyses, newest first."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request is invalid."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"A valid API key is required."}},"summary":"Search owned analyses","tags":["Analyses"]}},"/api/analysis/submit":{"post":{"description":"Queue one analysis per selected model. A profile supplies defaults first, then explicit values override it. Task, prompt, and at least one model must resolve from either source. Zero token, cost, or time limits mean unlimited.","operationId":"analysis_submit","requestBody":{"content":{"multipart/form-data":{"encoding":{"model":{"explode":true,"style":"form"}},"schema":{"properties":{"cost_limit":{"default":0,"description":"Inference cost limit in EUR; zero means unlimited.","minimum":0,"type":"number"},"file":{"description":"File to analyse.","format":"binary","type":"string"},"max_recursion":{"default":20,"description":"Maximum recursive file-analysis depth.","minimum":1,"type":"integer"},"model":{"description":"One or more configured model identifiers. Repeat the form field for multiple models.","items":{"type":"string"},"type":"array"},"profile":{"description":"Optional configured profile name.","type":"string"},"prompt":{"description":"Configured prompt name override.","type":"string"},"task":{"description":"Task override.","enum":["triage","behavior","unpack","config"],"type":"string"},"time_limit":{"default":0,"description":"Analysis time limit in minutes; zero means unlimited.","minimum":0,"type":"integer"},"token_limit":{"default":0,"description":"Cumulative inference-token limit; zero means unlimited.","minimum":0,"type":"integer"},"user_hint":{"description":"Optional short analyst context supplied to the analysis.","maxLength":512,"type":"string"}},"required":["file"],"type":"object"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisSubmission"}}},"description":"The analyses were queued."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request is invalid."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"A valid API key is required."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The authenticated account cannot perform this action."},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The submitted file exceeds the configured upload limit."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request could not be completed because stored data or an internal operation failed."}},"summary":"Submit a file for analysis","tags":["Analyses"]}},"/api/analysis/{analysis_id}":{"get":{"description":"Return the same analysis representation used by search.","operationId":"analysis_detail","parameters":[{"description":"Owned analysis identifier.","in":"path","name":"analysis_id","required":true,"schema":{"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Analysis"}}},"description":"Analysis details."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"A valid API key is required."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The owned resource was not found."}},"summary":"Get an analysis","tags":["Analyses"]}},"/api/analysis/{analysis_id}/annotations":{"get":{"description":"Return function renames and address comments grouped by analysed file, with downloads for retained sources and annotated Malcat bundles when available.","operationId":"analysis_annotations","parameters":[{"description":"Owned analysis identifier.","in":"path","name":"analysis_id","required":true,"schema":{"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Annotation"},"type":"array"}}},"description":"Annotations grouped by analysed file."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"A valid API key is required."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The owned resource was not found."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request could not be completed because stored data or an internal operation failed."}},"summary":"List analysis annotations","tags":["Results"]}},"/api/analysis/{analysis_id}/artifacts":{"get":{"description":"List retained returned objects from unpacking and reverse-engineering analyses. Each entry includes a secured hash-based download URL.","operationId":"analysis_artifacts","parameters":[{"description":"Owned analysis identifier.","in":"path","name":"analysis_id","required":true,"schema":{"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Artifact"},"type":"array"}}},"description":"Retained returned files."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"A valid API key is required."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The owned resource was not found."}},"summary":"List returned files","tags":["Results"]}},"/api/analysis/{analysis_id}/chat":{"get":{"description":"Download chat.json exactly as stored on disk, without parsing or reformatting it. Recovered partial chats from failed analyses are available when the file exists; no report.json or completed status is required. Private in-progress journals are not exposed.","operationId":"analysis_chat","parameters":[{"description":"Owned analysis identifier.","in":"path","name":"analysis_id","required":true,"schema":{"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array"}}},"description":"Stored chat.json attachment."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"A valid API key is required."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The owned resource was not found."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request could not be completed because stored data or an internal operation failed."}},"summary":"Download the AI chat log","tags":["Results"]}},"/api/analysis/{analysis_id}/configuration":{"get":{"description":"Return the configuration values recovered by a configuration task.","operationId":"analysis_configuration","parameters":[{"description":"Owned analysis identifier.","in":"path","name":"analysis_id","required":true,"schema":{"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object"}}},"description":"Extracted configuration object."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"A valid API key is required."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The owned resource was not found."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request could not be completed because stored data or an internal operation failed."}},"summary":"Get extracted configuration","tags":["Results"]}},"/api/analysis/{analysis_id}/detections":{"get":{"description":"Return job-wide detections and detections grouped by analysed file.","operationId":"analysis_detections","parameters":[{"description":"Owned analysis identifier.","in":"path","name":"analysis_id","required":true,"schema":{"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Detections"}}},"description":"Aggregate and per-file detections."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"A valid API key is required."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The owned resource was not found."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request could not be completed because stored data or an internal operation failed."}},"summary":"Get Kesakode detections","tags":["Results"]}},"/api/analysis/{analysis_id}/file-tree":{"get":{"description":"Return stored parent/child file relationships recorded during analysis.","operationId":"analysis_file_tree","parameters":[{"description":"Owned analysis identifier.","in":"path","name":"analysis_id","required":true,"schema":{"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array"}}},"description":"Recursive file relationship entries."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"A valid API key is required."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The owned resource was not found."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request could not be completed because stored data or an internal operation failed."}},"summary":"Get the recursive file tree","tags":["Results"]}},"/api/analysis/{analysis_id}/outputs":{"get":{"description":"Return availability, URLs, and counts for every supported stored output.","operationId":"analysis_outputs","parameters":[{"description":"Owned analysis identifier.","in":"path","name":"analysis_id","required":true,"schema":{"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisOutputs"}}},"description":"Output availability manifest."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"A valid API key is required."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The owned resource was not found."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request could not be completed because stored data or an internal operation failed."}},"summary":"Discover analysis outputs","tags":["Results"]}},"/api/analysis/{analysis_id}/report":{"get":{"description":"Download the task-focused AI narrative as a Markdown attachment.","operationId":"analysis_report","parameters":[{"description":"Owned analysis identifier.","in":"path","name":"analysis_id","required":true,"schema":{"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"text/markdown":{"schema":{"type":"string"}}},"description":"Markdown analysis report."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"A valid API key is required."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The owned resource was not found."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request could not be completed because stored data or an internal operation failed."}},"summary":"Download the AI report","tags":["Results"]}},"/api/analysis/{analysis_id}/status":{"get":{"description":"Compact polling response for an owned analysis.","operationId":"analysis_status","parameters":[{"description":"Owned analysis identifier.","in":"path","name":"analysis_id","required":true,"schema":{"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisStatus"}}},"description":"Current lifecycle status."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"A valid API key is required."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The owned resource was not found."}},"summary":"Get analysis status","tags":["Analyses"]}},"/api/analysis/{analysis_id}/technical-reports":{"get":{"description":"List static-analysis reports available for the root sample and analysed objects.","operationId":"analysis_technical_reports","parameters":[{"description":"Owned analysis identifier.","in":"path","name":"analysis_id","required":true,"schema":{"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/TechnicalReportSummary"},"type":"array"}}},"description":"Technical report summaries."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"A valid API key is required."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The owned resource was not found."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request could not be completed because stored data or an internal operation failed."}},"summary":"List technical reports","tags":["Results"]}},"/api/analysis/{analysis_id}/technical-reports/{object_analysis_id}":{"get":{"description":"Return the complete stored static-analysis report for one analysed object.","operationId":"analysis_technical_report","parameters":[{"description":"Owned analysis identifier.","in":"path","name":"analysis_id","required":true,"schema":{"minimum":1,"type":"integer"}},{"description":"Internal Malcat analysis identifier for an analysed object.","in":"path","name":"object_analysis_id","required":true,"schema":{"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TechnicalReport"}}},"description":"Complete technical report."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"A valid API key is required."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The owned resource was not found."},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request could not be completed because stored data or an internal operation failed."}},"summary":"Get a technical report","tags":["Results"]}},"/api/file/download/{sha256}":{"get":{"description":"Download a retained root sample, returned object, or annotated bundle by SHA-256. The file must belong to an analysis owned by the authenticated account.","operationId":"file_download","parameters":[{"description":"Exact SHA-256 digest of the retained file.","in":"path","name":"sha256","required":true,"schema":{"pattern":"^[0-9a-fA-F]{64}$","type":"string"}}],"responses":{"200":{"content":{"application/octet-stream":{"schema":{"format":"binary","type":"string"}}},"description":"Opaque file attachment."},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The request is invalid."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"A valid API key is required."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The owned resource was not found."}},"summary":"Download a retained file","tags":["Files"]}},"/api/models":{"get":{"operationId":"analysis_models","responses":{"200":{"content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array"}}},"description":"Configured model identifiers."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"A valid API key is required."}},"summary":"List available models","tags":["Configuration"]}},"/api/profiles":{"get":{"operationId":"analysis_profiles","responses":{"200":{"content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array"}}},"description":"Configured profile names."},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"A valid API key is required."}},"summary":"List available profiles","tags":["Configuration"]}}},"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}],"servers":[{"description":"Current server","url":"https://logos.malcat.fr"}],"tags":[{"description":"Submit, find, and monitor analyses.","name":"Analyses"},{"description":"Inspect the outputs retained for an analysis.","name":"Results"},{"description":"Download retained samples and returned objects.","name":"Files"},{"description":"Discover configured models and analysis profiles.","name":"Configuration"}]}
