Save to Box
Pricing
Pay per usage
Send the results of any Apify Actor to a Box folder as Excel, CSV or JSON, plus screenshots, PDFs and other files. Attach as an integration and every run lands in Box automatically.
Pricing
Pay per usage
Rating
0.0
(0)
Developer
Petros Hong
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
4 days ago
Last modified
Categories
Share
You can access the Save to Box programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.0", "x-build-id": "SKwCWqE1zdUGdHiTQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/petroshong1~save-to-box/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-petroshong1-save-to-box", "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/petroshong1~save-to-box/runs": { "post": { "operationId": "runs-sync-petroshong1-save-to-box", "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/petroshong1~save-to-box/run-sync": { "post": { "operationId": "run-sync-petroshong1-save-to-box", "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": { "folderId": { "title": "Box folder ID", "type": "string", "description": "Required to upload. Where files go. Open the folder in Box: the ID is the number at the end of the URL (app.box.com/folder/<b>123456789</b>). The Box app must have access to this folder (see README)." }, "boxClientId": { "title": "Box client ID", "type": "string", "description": "On your app's page in the Box Developer Console, open the App Details panel (icon at the top right, next to ⋯) and click Copy next to Client ID." }, "boxClientSecret": { "title": "Box client secret", "type": "string", "description": "Same panel: click Fetch Secret next to Client Secret. Stored encrypted, never shown in logs." }, "boxSubjectType": { "title": "Connect as", "enum": [ "enterprise", "user" ], "type": "string", "description": "Service account: files are owned by the app; share the target folder with the app's service account. Specific user: files are owned by that user (the app needs 'Generate user access tokens').", "default": "enterprise" }, "boxSubjectId": { "title": "Enterprise ID or user ID", "type": "string", "description": "Enterprise ID (Box Admin Console > Account & Billing), or the Box user ID if 'Connect as' is a specific user." }, "boxDeveloperToken": { "title": "Developer token (testing only)", "type": "string", "description": "Optional, for a quick test only: a 60-minute developer token from the Box Developer Console. It connects as you. Use client ID + secret for anything automatic." }, "formats": { "title": "Dataset formats", "type": "array", "description": "One file per format with all dataset items. Leave empty to skip the dataset.", "items": { "type": "string", "enum": [ "xlsx", "csv", "json", "jsonl", "xml", "html" ], "enumTitles": [ "Excel (.xlsx)", "CSV", "JSON", "JSON Lines", "XML", "HTML table" ] }, "default": [ "xlsx" ] }, "fields": { "title": "Only these fields", "type": "array", "description": "Optional. Keep only these columns (e.g. title, url, price). Empty = all fields.", "items": { "type": "string" } }, "saveFiles": { "title": "Also save files from the run", "type": "boolean", "description": "Upload records from the run's key-value store, e.g. screenshots, PDFs, HTML snapshots or reports. INPUT and internal state records are skipped.", "default": false }, "fileKeyPrefix": { "title": "File key prefix filter", "type": "string", "description": "Optional. Only upload key-value store records whose key starts with this (e.g. 'screenshot')." }, "maxFiles": { "title": "Max files per run", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Safety cap on how many key-value store files are uploaded per run.", "default": 200 }, "fileName": { "title": "File name", "type": "string", "description": "Variables: {actor}, {date}, {time}, {runId}. Extension is added. Tip: use a fixed name like '{actor} results' to keep ONE file whose Box version history holds every run.", "default": "{actor} {date} {time}" }, "subfolder": { "title": "Subfolder", "type": "string", "description": "Optional. Create/use a subfolder, e.g. '{actor}' or '{date}' or '{actor}/{date}'. Empty = save straight into the folder." }, "sharedLink": { "title": "Create shared link", "enum": [ "none", "collaborators", "company" ], "type": "string", "description": "Optionally create a Box shared link on each uploaded file (returned in the output).", "default": "none" }, "uploadEmpty": { "title": "Upload when the dataset is empty", "type": "boolean", "description": "Off by default, so runs that found nothing do not create empty files in Box.", "default": false }, "datasetId": { "title": "Dataset", "type": "string", "description": "When attached as an integration this is the triggering run's dataset ({{resource.defaultDatasetId}})." }, "keyValueStoreId": { "title": "Key-value store", "type": "string", "description": "When attached as an integration this is the triggering run's store ({{resource.defaultKeyValueStoreId}})." } } }, "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 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for Save to Box from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: