filescom-as2-incoming-messages ยท diff
git:20260924.4e0e2bc to git:20261026.06a2116
10 added, 0 removed. Audit A to A.
---
name: filescom-as2-incoming-messages
description: |
An AS2IncomingMessage is a single record created for each individual AS2 file transfer incoming from a Partner.
---
# filescom-as2-incoming-messages
An AS2IncomingMessage is a single record created for each individual AS2 file transfer incoming from a Partner. It contains the message details and tracks the lifecycle status with milestones of the transfer.
+ Replaying a retained message creates a new incoming message. Its `replayed_from_message_id` identifies the incoming-message record that was replayed. The original AS2 `message_id` is preserved. The source record ID remains available after that record is removed by message retention.
+
All subcommands also accept the flags documented in [`CONTEXT.md`](../../CONTEXT.md) (`--api-key`, `--format`, `--workspace-id`, `--debug`, and the pagination flags `--cursor` / `--per-page` / `--max-pages` on `list`). Those are not repeated below.
## Commands
### `files-cli as2-incoming-messages list`
List AS2 Incoming Messages.
| Flag | Type | Description |
| --- | --- | --- |
| `--sort-by` | object | If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `workspace_id`, `created_at` or `as2_partner_id`. |
| `--filter` | object | If set, return records where the specified field is equal to the supplied value. Valid fields are `created_at`, `as2_station_id`, `workspace_id` or `as2_partner_id`. Valid field combinations are `[ as2_station_id, created_at ]`, `[ workspace_id, created_at ]`, `[ as2_partner_id, created_at ]`, `[ workspace_id, as2_station_id ]`, `[ workspace_id, as2_partner_id ]`, `[ workspace_id, as2_station_id, created_at ]` or `[ workspace_id, as2_partner_id, created_at ]`. |
| `--filter-gt` | object | If set, return records where the specified field is greater than the supplied value. Valid fields are `created_at`. |
| `--filter-gteq` | object | If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at`. |
| `--filter-lt` | object | If set, return records where the specified field is less than the supplied value. Valid fields are `created_at`. |
| `--filter-lteq` | object | If set, return records where the specified field is less than or equal the supplied value. Valid fields are `created_at`. |
+
+ ### `files-cli as2-incoming-messages replay`
+
+ Replay AS2 Incoming Message.
+
+ | Flag | Type | Description |
+ | --- | --- | --- |
+ | `--id` | int64 | As2 Incoming Message ID. **Required.** |