---
canonical_url: "https://docs.composio.dev/toolkits/archive_org"
markdown_url: "https://docs.composio.dev/toolkits/archive_org.md"
product: "platform"
version: null
last_updated: null
---

# Archive.org

Search and access Internet Archive content, inspect analytics, Wayback captures, IIIF images, and account tasks, and manage item files, metadata, derivation, and the connected user's reviews.

- **Category:** content & files
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 26
- **Triggers:** 0
- **Slug:** `ARCHIVE_ORG`
- **Version:** 00000000_00

## Tools

### Advanced Search Archive.org Items

**Slug:** `ARCHIVE_ORG_ADVANCED_SEARCH_ITEMS`

Search Archive.org metadata with exact Advanced Search page semantics. Use Search Archive.org Items instead when cursor-based deep paging is needed.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | One-based page number. Sorted searches must remain within the first 10,000 results; unsorted searches may page deeper. |
| `rows` | integer | No | Number of items to return on this page (1-100). |
| `sort` | array | No | Sort expressions accepted by Archive.org, in priority order. |
| `query` | string | Yes | Lucene-style Archive.org metadata query. |
| `fields` | array | No | Metadata fields to return. The identifier field is always included so results can be used with item tools. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check Identifier Availability

**Slug:** `ARCHIVE_ORG_CHECK_IDENTIFIER_AVAILABILITY`

Check whether an Archive.org item identifier is available before attempting to create an item.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `identifier` | string | Yes | Proposed Archive.org item identifier to check. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Check Archive.org Upload Limit

**Slug:** `ARCHIVE_ORG_CHECK_UPLOAD_LIMIT`

Check whether Archive.org's ingest queue is likely to accept an upload or delete, using only the connection's LOW Authorization header.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `bucket` | string | No | Optional Archive.org item identifier for a bucket-specific upload preflight. Omit it for the connected account's general state. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Copy Item File

**Slug:** `ARCHIVE_ORG_COPY_ITEM_FILE`

Copy one Archive.org file server-side to a named path in an existing destination item. This creates the destination file when absent and overwrites it when present while preserving the prior destination under history/files. The source remains unchanged. This action never queues derivation; use DERIVE_ITEM for that separate irreversible effect. Catalog visibility may lag after IA-S3 accepts the copy.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `source_filename` | string | Yes | Exact source filename, optionally including nested path segments. |
| `source_identifier` | string | Yes | Archive.org item identifier containing the source file. |
| `destination_filename` | string | Yes | Destination filename, optionally including nested path segments. An existing file at this path is overwritten. |
| `destination_identifier` | string | Yes | Existing Archive.org item identifier that will receive the copied file. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Item File

**Slug:** `ARCHIVE_ORG_DELETE_ITEM_FILE`

Submit asynchronous deletion of one named file from an Archive.org item through IA-S3. An accepted response does not verify file absence; read item metadata later to verify it. This action cannot delete an item/bucket. Cascade deletion is disabled by default and must be explicitly enabled.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cascade` | boolean | No | Also delete originals and derivatives related to this file. Defaults to false; set true only when that broader destructive effect is intended. |
| `filename` | string | Yes | Exact file to delete, optionally including nested path segments. A filename is required; deleting an item/bucket is not supported. |
| `identifier` | string | Yes | Archive.org item identifier containing the file. |
| `keep_old_version` | boolean | No | Keep the deleted file under history/files instead of discarding its old version. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete My Archive.org Review

**Slug:** `ARCHIVE_ORG_DELETE_MY_REVIEW`

Permanently delete the connected Archive.org user's public review from one item. Archive.org queues the deletion and rejects the request if no such review exists.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `identifier` | string | Yes | Archive.org item identifier whose connected-user review will be deleted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Derive Archive.org Item

**Slug:** `ARCHIVE_ORG_DERIVE_ITEM`

Queue Archive.org's fixed derive.php task for an item owned or editable by the connected account. The task transforms source content into derived files asynchronously and may replace prior derivatives; this action never requests the untested remove_derived option.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `priority` | integer | No | Optional derive.php task priority from -10 to 10; default is 0. |
| `identifier` | string | Yes | Archive.org item identifier. The connected account must own the item or have permission to edit it. |
| `accept_reduced_priority` | integer | No | Send 1 to let Archive.org queue at a reduced priority instead of rate limiting when possible; send null to omit the header. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Download Item File

**Slug:** `ARCHIVE_ORG_DOWNLOAD_ITEM_FILE`

Download one public file from an Archive.org item and return a temporary downloadable file reference.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filename` | string | Yes | Exact file name from Get Item Metadata's files list, including any nested path and extension. |
| `byte_range` | string | No | Optional single HTTP byte range, such as 'bytes=0-1023', or 'bytes=-1024'. The range must be bounded to at most 10 MiB; open-ended and multiple ranges are rejected. |
| `identifier` | string | Yes | Archive.org item identifier containing the file. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Find Wayback Snapshots

**Slug:** `ARCHIVE_ORG_FIND_WAYBACK_SNAPSHOTS`

Find the closest archived Wayback Machine snapshot for each requested URL, using one before, after, or either direction for the batch.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `closest` | string ("either" | "before" | "after") | No | Direction applied to every URL in this batch: nearest capture on either side of its timestamp, only before, or only after. |
| `timeout` | number | No | Maximum seconds Archive.org should wait for its underlying CDX lookup; omit to use the documented five-second provider default. |
| `requests` | array | Yes | URLs to check; each entry may specify its own timestamp preference and correlation tag. |
| `status_codes` | array | No | Recorded HTTP statuses eligible for every result in the batch. Values are sent as the documented repeated status_code query parameter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Connected Archive.org User

**Slug:** `ARCHIVE_ORG_GET_CONNECTED_USER`

Return the authenticated Archive.org user's identity and privileges without returning either IA-S3 credential.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Detailed Archive.org Views

**Slug:** `ARCHIVE_ORG_GET_DETAILED_VIEWS`

Get bounded geographic view analytics and, for items, top referrers over a recent window or date range. Collections support both timeframes; contributors support date ranges only and do not include referrers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `subject` | string | Yes | Collection/item identifier or exact contributor value. |
| `end_date` | string | No | Exclusive ISO end date for range mode; range may span at most 31 days. |
| `timeframe` | string ("recent" | "range") | Yes | Use recent for a last-N-days collection/item query or range for dates. |
| `start_date` | string | No | Inclusive ISO start date for range mode. |
| `last_n_days` | integer | No | Recent day count (1-31); valid only for collection or item subjects. |
| `subject_type` | string ("collection" | "item" | "contributor") | Yes | Analytics subject: an Archive.org collection, item, or contributor. |
| `max_referrers` | integer | No | Maximum highest-score referrers to return for an item (0-100); collection and contributor analytics do not provide referrers. |
| `max_geo_records` | integer | No | Maximum highest-count geographic bins to return (1-200). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get IIIF Image Info

**Slug:** `ARCHIVE_ORG_GET_IIIF_IMAGE_INFO`

Get normalized IIIF Image API capabilities through Archive.org's fixed-host single-image convenience route or a live-proven versioned file route.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `filename` | string | No | Exact image filename. Omit to use Archive.org's convenience route for a single-image item. |
| `identifier` | string | Yes | Archive.org item identifier containing the image. |
| `api_version` | integer ("2" | "3") | No | Live Image API route version; required with filename and otherwise omitted. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get IIIF Manifest

**Slug:** `ARCHIVE_ORG_GET_IIIF_MANIFEST`

Get a compact IIIF Presentation manifest for an Archive.org item or one page of an Archive.org collection.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `identifier` | string | Yes | Archive.org item or collection identifier. |
| `next_cursor` | string | No | Opaque collection-page cursor returned by a previous call; valid only for a collection manifest. |
| `manifest_type` | string ("item" | "collection") | No | Return an item Presentation manifest or one collection page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Item Metadata

**Slug:** `ARCHIVE_ORG_GET_ITEM_METADATA`

Get an Archive.org item's full record, including metadata, file inventory, public reviews, and catalog tasks, or return one selected metadata field or array slice.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `count` | integer | No | Maximum array elements to return when field_path selects an array. |
| `start` | integer | No | Zero-based start index when field_path selects an array; omit for non-array fields or a full record. |
| `field_path` | string | No | Slash-separated metadata path to return only one value, such as 'metadata/title' or 'files'; omit for the full item record. |
| `identifier` | string | Yes | Archive.org item identifier. |
| `primary_files_only` | boolean | No | For a full record, return only primary files when true. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Item View Counts

**Slug:** `ARCHIVE_ORG_GET_ITEM_VIEW_COUNTS`

Get all-time, last-30-day, and last-7-day view counts for one or more Archive.org item or collection identifiers from the current or legacy counting pipeline.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `source` | string ("current" | "legacy") | No | Counting pipeline to query. Use current for the recommended views data or legacy only when comparing against historical download-count metrics. |
| `identifiers` | array | Yes | Archive.org item or collection identifiers whose summary view counts should be returned. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Item View History

**Slug:** `ARCHIVE_ORG_GET_ITEM_VIEW_HISTORY`

Get a bounded daily view history for one Archive.org item or collection, split by robot classification.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end_date` | string | No | Last ISO date to return, inclusive; requires start_date. |
| `max_days` | integer | No | Most recent number of available days to return when no date range is set. |
| `identifier` | string | Yes | One Archive.org item or collection identifier. |
| `start_date` | string | No | First ISO date to return; requires end_date and allows at most 366 days. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get My Review

**Slug:** `ARCHIVE_ORG_GET_MY_REVIEW`

Get the connected Archive.org user's review for one item, if that user has reviewed it.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `identifier` | string | Yes | Archive.org item identifier whose connected-user review should be returned. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Archive.org Task Log

**Slug:** `ARCHIVE_ORG_GET_TASK_LOG`

Download a plain-text log for a task visible to the connected account. Optionally return only the first or last requested number of lines.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lines` | integer | No | Optional documented line bound: positive returns the first N lines and negative returns the last N lines (up to 1000 either way). |
| `task_id` | integer | Yes | Resource-authorized Archive.org task identifier whose log to download. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Task Rate Limits

**Slug:** `ARCHIVE_ORG_GET_TASK_RATE_LIMITS`

Report the connected account's current task capacity and in-flight counts for one Archive.org catalog command.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `command` | string | Yes | Catalog command whose current Archive.org task capacity should be checked, such as 'derive.php' or 'modify_xml.php'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Archive.org Tasks

**Slug:** `ARCHIVE_ORG_LIST_TASKS`

Return any documented combination of the connected account's task summary, active catalog, and resource-authorized history, one page at a time.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `args` | string | No | Filter the provider task argument list; '*' and '%' wildcards are allowed. |
| `view` | string ("summary" | "catalog" | "history") | No | Task data to return: aggregate summary, active catalog tasks, or item/task-specific history. |
| `color` | string | No | Filter by provider run-state color, such as green, blue, red, or brown. |
| `limit` | integer | No | Maximum task records to return in this page (1-500). |
| `server` | string | No | Filter by the Archive.org execution node; '*' and '%' wildcards are allowed. |
| `status` | string | No | Filter catalog or history tasks by provider task status. |
| `command` | string | No | Filter tasks by command name, such as 'derive.php'. |
| `task_id` | integer | No | Specific task identifier. For history, use it alone or with identifier to narrow the result. |
| `priority` | integer | No | Filter by task priority, generally from -10 through 10. |
| `submitter` | string | No | Filter by submitting Archive.org user; '*' and '%' wildcards are allowed. |
| `categories` | array | No | Task categories to combine in one response. Use any of summary, catalog, and history. Omit this field to retain the legacy single-category view. |
| `identifier` | string | No | Archive.org item identifier. History requires identifier, task_id, or both; this field is optional for catalog filtering. |
| `wait_admin` | integer ("0" | "1" | "2" | "9") | No | Filter by numeric run state: 0 queued, 1 running, 2 error, or 9 paused. |
| `next_cursor` | string | No | Opaque cursor from the previous List Archive.org Tasks response. It retains the original view and filters; omit it for the first page. |
| `submitted_after` | string | No | Filter to tasks submitted strictly after this provider-parseable date/time. |
| `submitted_before` | string | No | Filter to tasks submitted strictly before this provider-parseable date/time. |
| `submitted_at_or_after` | string | No | Filter to tasks submitted at or after this provider-parseable date/time. |
| `submitted_at_or_before` | string | No | Filter to tasks submitted at or before this provider-parseable date/time. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Wayback Captures

**Slug:** `ARCHIVE_ORG_LIST_WAYBACK_CAPTURES`

Return one bounded structured CDX page of Wayback captures for a URL or host.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | URL or host to query in the Wayback CDX index. Wildcards are permitted as documented by CDX. |
| `limit` | integer | No | Maximum captures in this page (1-1000). |
| `fields` | array | No | Exact public CDX fields to return, in response-column order. |
| `filters` | array | No | Documented field regular-expression filters, combined with AND semantics. |
| `collapse` | array | No | Documented adjacent-record collapse controls. |
| `match_type` | string ("exact" | "prefix" | "host" | "domain") | No | Scope of URL matching. |
| `next_cursor` | string | No | Opaque cursor from the previous call; it restores the original query. |
| `to_timestamp` | string | No | Inclusive ending timestamp using 1 to 14 digits from year onward. |
| `from_timestamp` | string | No | Inclusive starting timestamp using 1 to 14 digits from year onward. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Render IIIF Image

**Slug:** `ARCHIVE_ORG_RENDER_IIIF_IMAGE`

Render a bounded crop, resize, rotation, quality, and format from a fixed Archive.org IIIF image route.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `size` | string | No | IIIF output size: 'full' for API 2 or 'max' for API 3; 'pct:n' with 0 < n <= 100; 'width,' or ',height' preserving aspect ratio; 'width,height' for exact dimensions; or '!width,height' to fit within a box without upscaling. Explicit dimensions are positive integers no larger than 4096; output is also capped at 4,000,000 pixels. |
| `format` | string ("jpg" | "png" | "gif" | "tif" | "jp2" | "pdf" | "webp") | No | IIIF output format. |
| `region` | string | No | IIIF crop region: 'full', centered 'square', pixel 'x,y,width,height' using nonnegative integers and positive dimensions, or percentage 'pct:x,y,width,height' whose coordinates and extent stay within 0-100. |
| `quality` | string ("default" | "color" | "gray" | "bitonal") | No | IIIF output quality. |
| `filename` | string | Yes | Exact source image filename. |
| `rotation` | string | No | Clockwise IIIF rotation from 0 through 360 degrees, optionally prefixed with '!' to mirror before rotating; use canonical integers or decimals. |
| `identifier` | string | Yes | Archive.org item identifier. |
| `api_version` | integer ("2" | "3") | Yes | Live IIIF Image API route version. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Archive.org Items

**Slug:** `ARCHIVE_ORG_SEARCH_ITEMS`

Search Archive.org item metadata with a Lucene-style query and return one deep-pagination page of matching items.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `sort` | array | No | Sort expressions accepted by Archive.org search, in priority order. |
| `limit` | integer | No | Number of matches to request in this page (100-10000). |
| `query` | string | Yes | Lucene-style Archive.org metadata query, such as 'collection:opensource_movies AND mediatype:movies'. |
| `fields` | array | No | Metadata fields to return for each item. The identifier field is always included so results can be used with item tools. |
| `total_only` | boolean | No | Return only the number of matching items. When true, items is empty and no continuation cursor is returned. |
| `next_cursor` | string | No | Opaque cursor returned by the previous Search Archive.org Items call; omit for the first page. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Item Metadata

**Slug:** `ARCHIVE_ORG_UPDATE_ITEM_METADATA`

Apply JSON Patch changes to one Archive.org item owned or editable by the connected account, limited to ordinary item metadata and metadata records for named files. Remove permanently deletes the selected metadata value; move removes a value from its source path and adds it elsewhere within the same target. File bytes are never moved or removed. Archive.org validates the whole request under an item lock, and multiple target changes are atomic. SimpleLists, reviews, and custom user JSON targets are deferred.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `changes` | array | Yes | Nonempty target-and-patch changes. One change uses Archive.org's single-target form; multiple changes use its atomic multi-target form. |
| `priority` | integer | No | Optional modify_xml.php task priority from -10 to 10; default is 0. |
| `identifier` | string | Yes | Archive.org item identifier. The connected account must own the item or have permission to edit it. |
| `accept_reduced_priority` | integer | No | Send 1 to let Archive.org queue at a reduced priority instead of rate limiting when possible; send null to omit the header. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upload Item File

**Slug:** `ARCHIVE_ORG_UPLOAD_ITEM_FILE`

Create or replace one file through Archive.org IA-S3, explicitly choosing a new-item or existing-item upload. New-item uploads alone send item creation metadata. Overwrites preserve the prior file under history/files, and this action never queues derivation; use DERIVE_ITEM for that separate irreversible effect. Input buffering is limited by the platform-configured maximum file download size. Acceptance does not mean catalog ingest is complete.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `file` | object | Yes | File whose raw bytes will be uploaded. The file is buffered subject to the platform-configured maximum file download size. |
| `title` | string | No | Human-readable title required when create_item=true. |
| `filename` | string | Yes | Destination filename, optionally including nested path segments. |
| `mediatype` | string ("audio" | "data" | "image" | "movies" | "software" | "texts" | "web") | No | Archive.org media type required when create_item=true. Use 'data' for a generic test item. |
| `collection` | string | No | Archive.org collection required when create_item=true. Use 'test_collection' for disposable test items. |
| `identifier` | string | Yes | Destination Archive.org item identifier. Set create_item=true only when this identifier is known not to exist. |
| `create_item` | boolean | Yes | Set true to create a new persistent item, or false to upload into an existing item. Creation metadata is sent only when true. |
| `interactive` | boolean | No | Request interactive queue priority. Do not mix priority settings across transactions on the same item because operations may be reordered. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Upsert My Archive.org Review

**Slug:** `ARCHIVE_ORG_UPSERT_MY_REVIEW`

Create or overwrite the connected Archive.org user's single public review for an eligible item. The title, body, and optional rating become publicly visible on the item.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `body` | string | Yes | Multiline body for the public review. |
| `stars` | integer | No | Optional public star rating from 0 to 5; Archive.org defaults to 0. |
| `title` | string | Yes | Single-line title for the public review. |
| `identifier` | string | Yes | Archive.org item identifier. Collections and user items cannot be reviewed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |