{ "openapi": "3.0.1", "info": { "title": "Is This File Safe? True Type, Macros, PDF JavaScript & Metadata", "description": "Before an agent opens a file: true type by magic bytes vs its extension, Office macros, PDF JavaScript and launch actions, archive bombs, embedded files and hidden author/GPS metadata. One safe, review or block verdict per file. Static analysis only, files are never executed.", "version": "1.0", "x-build-id": "QrTBalujwOJJ8B4gL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/that_red_bird~file-safety-inspector/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-that_red_bird-file-safety-inspector", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/that_red_bird~file-safety-inspector/runs": { "post": { "operationId": "runs-sync-that_red_bird-file-safety-inspector", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/that_red_bird~file-safety-inspector/run-sync": { "post": { "operationId": "run-sync-that_red_bird-file-safety-inspector", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "fileUrls": { "title": "File URLs", "type": "array", "description": "Public http(s) URLs of the files to check (PDF, Office, images, archives, anything). Leave all inputs empty to inspect 8 harmless built-in demo files that show every verdict.", "default": [], "items": { "type": "string" } }, "keyValueStoreId": { "title": "Key-value store with files (optional)", "type": "string", "description": "Pick a key-value store, for example the one filled by Website Content Crawler, and every record in it (up to Max files) is inspected. Each record key is used as the file name." }, "recordKeys": { "title": "Record keys", "type": "array", "description": "Only inspect these records of the selected key-value store. Leave empty to inspect all records except INPUT, OUTPUT and SUMMARY.", "default": [], "items": { "type": "string" } }, "datasetId": { "title": "Dataset with file URLs (optional)", "type": "string", "description": "Pick a dataset that has a column of file URLs, for example a crawler output. The URLs are downloaded and inspected." }, "urlField": { "title": "URL column name", "type": "string", "description": "Name of the dataset column that holds the file URL. Only used when a dataset is selected.", "default": "url" }, "macroPolicy": { "title": "Macro policy", "enum": [ "review", "block" ], "type": "string", "description": "What to do with files that contain VBA macros without clearly malicious behaviour. 'review' flags them, 'block' treats every macro as a block. Macros that start automatically and call shell or download functions are always blocked.", "default": "review" }, "blockExecutables": { "title": "Flag executables and scripts", "type": "boolean", "description": "Flag files that are executables or scripts (exe, dll, bat, ps1, js, lnk and similar) for review, and block them when their file name claims to be something harmless. Turn off for source-code repositories.", "default": true }, "maxFileMb": { "title": "Max file size (MB)", "minimum": 1, "maximum": 100, "type": "integer", "description": "Files larger than this are inspected only up to this size and marked for review. Files are held in memory.", "default": 25 }, "maxFiles": { "title": "Max files", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Upper limit of files inspected per run, taken from URLs first, then the store, then the dataset.", "default": 100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }