git:20260604.f117d9f to git:20260612.382a58f

4 added, 4 removed. Audit A to A.

---

name: filescom-partner-site-requests

description: |

- A PartnerSiteRequest represents a request to link a partner's Files.com site with another Files.com site.

+ A PartnerSiteRequest represents a request for a Guest Partner to add their Files.com Site to their Partnership with the Host Partner.

---

# filescom-partner-site-requests

- A PartnerSiteRequest represents a request to link a partner's Files.com site with another Files.com site.

+ A PartnerSiteRequest represents a request for a Guest Partner to add their Files.com Site to their Partnership with the Host Partner. The Guest Partner's Files.com Site is referred to as the Guest Site in this relationship.

- The Site with the Partner can initiate a request, which generates a pairing key. The target site admin must then approve the request using the pairing key.

+ The Partner Admin user representing the Guest on the Host Partner can initiate a request, which generates a pairing key. The Guest Site admin must then approve the request. This ensures that the Partner Admin user representing the Guest on the Host Partner and the Site Admins of the Site are in agreement that the linking should occur.

All subcommands also accept the global 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 partner-site-requests list`

List Partner Site Requests.

No flags beyond the global ones.

### `files-cli partner-site-requests find-by-pairing-key`

Find partner site request by pairing key.

| Flag | Type | Description |

| --- | --- | --- |

| `--pairing-key` | string | Pairing key for the partner site request **Required.** |

### `files-cli partner-site-requests create`

Create Partner Site Request.

| Flag | Type | Description |

| --- | --- | --- |

- | `--partner-id` | int64 | Partner ID to link with **Required.** |

+ | `--host-partner-id` | int64 | Host Partner ID to link with **Required.** |

| `--site-url` | string | Site URL to link to **Required.** |

### `files-cli partner-site-requests reject`

Reject partner site request.

| Flag | Type | Description |

| --- | --- | --- |

| `--id` | int64 | Partner Site Request ID. **Required.** |

### `files-cli partner-site-requests approve`

Approve partner site request.

| Flag | Type | Description |

| --- | --- | --- |

| `--id` | int64 | Partner Site Request ID. **Required.** |

### `files-cli partner-site-requests delete`

Delete Partner Site Request.

| Flag | Type | Description |

| --- | --- | --- |

| `--id` | int64 | Partner Site Request ID. **Required.** |