{ "openapi": "3.0.1", "info": { "title": "Spec Book to Submittal Register (CSI MasterFormat, Procore)", "description": "Spec book to submittal register: turn a construction project manual PDF into a CSI MasterFormat section index and a submittal register with paragraph references (1.3.A) and page numbers, plus a Procore import CSV. Rules-based, no AI. $0.05 per spec page; failed books free.", "version": "0.1", "x-build-id": "ChBfxg2PfULKAmubS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/hanielazevedo~spec-book-submittal-register/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-hanielazevedo-spec-book-submittal-register", "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/hanielazevedo~spec-book-submittal-register/runs": { "post": { "operationId": "runs-sync-hanielazevedo-spec-book-submittal-register", "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/hanielazevedo~spec-book-submittal-register/run-sync": { "post": { "operationId": "run-sync-hanielazevedo-spec-book-submittal-register", "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": { "pdfUrls": { "title": "Spec book PDF URLs (public)", "type": "array", "description": "Public http(s) links to spec books / project manuals (text PDFs exported from Word, MasterSpec, BSD SpecLink, etc.; scanned PDFs are not OCRed). To use files from your Apify account, put them in a key-value store and select it below: this Actor runs with limited permissions and cannot read a store you have not selected. The prefilled public demo book (Story County, Iowa, 380 pages) is processed free of charge.", "items": { "type": "string" } }, "pdfStore": { "title": "Spec book key-value store", "type": "string", "description": "Your Apify key-value store holding the spec book PDFs (Console > Storage > Key-value stores). Selecting it grants this run read-only access to that one store. Without record keys, every record whose key ends in \".pdf\" is processed." }, "pdfKeys": { "title": "PDF record keys", "type": "array", "description": "Optional. Keys of the PDF records in the selected store, e.g. \"project-manual.pdf\". Leave empty to use every \"*.pdf\" record.", "items": { "type": "string" } }, "includeDivision01": { "title": "Mine Divisions 00-01 for submittals", "type": "boolean", "description": "Divisions 00 (procurement/contracting) and 01 (general requirements) are always listed in the section index. By default their submittal paragraphs are not put in the register, because they describe procedures (submittal schedule, formats) rather than product submittals. Turn on to include them.", "default": false }, "includeWarranty": { "title": "Include warranty submittals", "type": "boolean", "description": "Add special/manufacturer/installer warranties from the WARRANTY article of PART 1 as closeout submittals.", "default": true }, "sectionNumberFormat": { "title": "Section number format", "enum": [ "spaced", "compact", "dotted", "as-printed" ], "type": "string", "description": "How section numbers are written in the outputs. Procore imports need the number exactly as it appears in your project's Specifications tool, so pick the matching format.", "default": "spaced" }, "procoreSubmittalManager": { "title": "Procore Submittal Manager (email)", "type": "string", "description": "Optional. Email of the Procore user to set as Submittal Manager on every row of PROCORE_IMPORT.csv. Procore requires this column for an import; the user must already be in the project Directory." }, "procoreSubmittalStatus": { "title": "Procore Submittal Status", "type": "string", "description": "Optional. Status written to PROCORE_IMPORT.csv (must match a status in your Procore project, e.g. Draft or Open). Blank = Procore's default (Draft)." }, "maxPages": { "title": "Max pages per book", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Only the first N pages of each PDF are read.", "default": 2000 }, "maxFileSizeMb": { "title": "Max file size (MB)", "minimum": 1, "maximum": 300, "type": "integer", "description": "Larger files are rejected (not charged).", "default": 150 } } }, "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 } } } } } } } } } }