# Launch Sharing

> Share one launch with other accounts through invites, and manage the grants that result.

Launch Sharing lets the owner of a launch bring other accounts onto it without handing over the license. Access is a **grant**: a literal list of permission identifiers taken from the permission catalog, plus the wallets the grantee may act on or export. The launch, its wallets and its revenue stay with the owner.

Accounts join through an **invite**. A `link` invite is open to anyone holding the URL for 24 hours; each click files a `request` that the grantor approves or revokes. A `direct` invite names one account by username, which accepts or declines it from its incoming queue. Accepting a direct invite or approving a request creates the grant.

In the web app this is the **Collaborate** modal on a live launch, the pending-invites menu in the bottom bar, and the join page behind `/invite/{token}`. Every route here is keyed by the launch `ext_id`, the 15-digit, chain-encoded identifier the app uses as `launch_id`.

Base URL: `https://api-mig.proxima.tools`

## Endpoints

- `GET /launch/shares/catalog`: Retrieve the permission catalog
- `GET /launch/shares/{launch_id}/resources`: List shareable wallets
- `GET /launch/shares/{launch_id}`: List grants on a launch
- `GET /launch/shares/{launch_id}/{grant_id}`: Retrieve a grant
- `POST /launch/shares/{launch_id}/invites`: Create an invite
- `GET /launch/invites/managed`: List managed invites
- `DELETE /launch/shares/{launch_id}/invites/{invite_id}`: Revoke an invite
- `POST /launch/shares/{launch_id}/invites/{invite_id}/approve`: Approve a join request
- `GET /launch/invites/link/{token}`: Preview an invite link
- `POST /launch/invites/link/{token}/request`: Request to join through a link
- `GET /launch/invites/incoming`: List incoming invites
- `POST /launch/invites/{invite_id}/accept`: Accept an invite
- `POST /launch/invites/{invite_id}/decline`: Decline an invite
- `PATCH /launch/shares/{launch_id}/{grant_id}`: Update a grant
- `DELETE /launch/shares/{launch_id}/{grant_id}`: Revoke a grant
- `GET /launch/shares/{launch_id}/{grant_id}/jobs`: List a grant's jobs
- `GET /launch/shares/{launch_id}/transfer-check`: Check ownership transfer
- `GET /launch/shared`: List launches shared with you
- `DELETE /launch/shared/{grant_id}`: Leave a shared launch

## The Grant object

A set of rights on one launch held by another account. Grants form a tree: a grantee holding `access.manage` can re-share a subset of its own rights, creating a child grant.

- `id` (string): Unique identifier (UUID).
- `parent_grant_id` (string | null): Grant this one was re-shared from. `null` for a grant issued by the owner.
- `version` (integer): Revision number. Send it as `If-Match` when updating the grant.
- `catalog_version` (integer): Version of the permission catalog that expanded `operations`.
- `launch_ext_id` (integer): The launch `ext_id`.
- `chain` (string): Chain ID of the launch, e.g. `sol` or `base`.
- `depth` (integer): Position in the re-share chain. `0` for a grant issued by the owner.
- `operations` (array<string>): Permission identifiers the grant carries, e.g. `launch.read`, `trade.buy`.
- `export_keys` (array<object>): [Wallet references](#object-wallet-reference) whose secret key the grantee may export.
- `use_wallets` (array<object>): [Wallet references](#object-wallet-reference) the grantee may act on.
- `allow_future_wallets` (boolean): Whether the grant also covers wallets added to the launch later.
- `shared_spend_wallets` (array<object>): [Wallet references](#object-wallet-reference) that also serve outside this launch and that the grantee may spend from.
- `constraints` (object): Limits attached to the grant.
  - `withdraw_destinations` (array<object>): Addresses the grantee may withdraw to.
    - `chain` (string): Chain ID of the destination.
    - `address` (string): Destination address.
  - `max_new_wallets` (integer | null): Cap on wallets the grantee may add.
- `expires_at` (string | null): ISO 8601 expiry. `null` means the grant never expires.
- `revoked_at` (string | null): ISO 8601 time the grant was revoked, or `null`.
- `created_at` (string): ISO 8601 creation time.
- `grantee` (string | null): Username of the beneficiary. Never its license key.
- `grantee_display_name` (string | null): Display name of the beneficiary.
- `grantee_avatar_url` (string | null): Avatar URL of the beneficiary.
- `effective_operations` (array<string>): Only on a single-grant read: operations left once every ancestor grant is applied.
- `effective_export_keys` (array<object>): Only on a single-grant read: exportable wallets left across the chain.
- `effective_use_wallets` (array<object>): Only on a single-grant read: usable wallets left across the chain.
- `effective_allow_future_wallets` (boolean): Only on a single-grant read: whether future wallets are covered across the chain.
- `effective_shared_spend_wallets` (array<object>): Only on a single-grant read: shared-spend wallets left across the chain.
- `effective_withdraw_destinations` (array<object>): Only on a single-grant read: withdraw destinations left across the chain.

```json
{
  "id": "a037996a-b1ed-4133-b495-3ba07c7249ad",
  "parent_grant_id": null,
  "version": 3,
  "catalog_version": 2,
  "launch_ext_id": 101920010239643,
  "chain": "sol",
  "depth": 0,
  "operations": [
    "launch.read",
    "history.read",
    "trade.buy",
    "trade.sell",
    "automation.autosell"
  ],
  "export_keys": [],
  "use_wallets": [
    {
      "kind": "svm_wallet",
      "wallet_id": 48213,
      "pubkey": "nAPGFAYA6VRUYnJcHLhs7UCVVFpB1SuBng9U1k1JRP8E"
    }
  ],
  "allow_future_wallets": false,
  "shared_spend_wallets": [],
  "constraints": {
    "withdraw_destinations": [
      {
        "chain": "sol",
        "address": "bYoWcksfWCXUEedVkM8yzXcGckvnhAdtaTDywkorRTdj"
      }
    ],
    "max_new_wallets": null
  },
  "expires_at": "2026-12-01T00:00:00Z",
  "revoked_at": null,
  "created_at": "2026-11-02T10:15:00Z",
  "grantee": "demo-trader",
  "grantee_display_name": "Demo Trader",
  "grantee_avatar_url": null
}
```

## The Invite object

A pending offer of rights on a launch. `link` and `direct` invites are opened by a grantor; a `request` is filed when someone clicks a link. An invite carries the same configuration the resulting grant will hold.

- `id` (string): Unique identifier (UUID).
- `kind` (enum): `link` (open URL), `direct` (addressed to one username) or `request` (filed by a link click). Possible values: `link`, `direct`, `request`.
- `launch_ext_id` (integer): The launch `ext_id`.
- `chain` (string): Chain ID of the launch.
- `inviter` (string | null): Username of whoever sent the invite.
- `inviter_display_name` (string | null): Display name of the inviter.
- `inviter_avatar_url` (string | null): Avatar URL of the inviter.
- `invitee` (string | null): Username of the named invitee (`direct`) or of the requesting account (`request`).
- `invitee_display_name` (string | null): Display name of the invitee.
- `invitee_avatar_url` (string | null): Avatar URL of the invitee.
- `name` (string | null): Token name of the launch.
- `symbol` (string | null): Token symbol of the launch.
- `image_url` (string | null): Token image URL.
- `mint_pubkey` (string | null): Token mint or contract address.
- `launch_platform` (string | null): Launchpad the token is deployed on.
- `launch_status` (string | null): Launch status, e.g. `Draft`, `Staged`, `Pending`, `Finalized`.
- `operations` (array<string>): Permission identifiers the resulting grant will carry.
- `export_keys` (array<object>): [Wallet references](#object-wallet-reference) whose key the grant will let the grantee export.
- `allow_future_wallets` (boolean): Whether the grant will cover wallets added later.
- `grant_expires_at` (string | null): ISO 8601 expiry the resulting grant will carry.
- `max_uses` (integer | null): Legacy link cap. `null` means unlimited, which every link now is.
- `uses_count` (integer): Number of requests a link has gathered.
- `expires_at` (string): ISO 8601 time the invite itself lapses.
- `created_at` (string): ISO 8601 creation time.
- `token` (string): Link token, used in the `/invite/{token}` URL. Returned when a link is created, and on the owner's managed list while the link is live.

```json
{
  "id": "d71fa141-da50-4ffd-819e-a228f21db19c",
  "kind": "link",
  "launch_ext_id": 101920010239643,
  "chain": "sol",
  "inviter": "launchlab",
  "inviter_display_name": "Launch Lab",
  "inviter_avatar_url": null,
  "invitee": null,
  "invitee_display_name": null,
  "invitee_avatar_url": null,
  "name": "Moon Otter",
  "symbol": "OTTER",
  "image_url": "https://cdn.example.com/tokens/otter.png",
  "mint_pubkey": "Fe7dTUwYvLw7znvXqijANZgztiDVWiE4J3cjDs6RiaZ",
  "launch_platform": "pumpfun",
  "launch_status": "Finalized",
  "operations": [
    "launch.read",
    "history.read",
    "trade.buy",
    "trade.sell"
  ],
  "export_keys": [],
  "allow_future_wallets": false,
  "grant_expires_at": null,
  "max_uses": null,
  "uses_count": 2,
  "expires_at": "2026-11-03T10:15:00Z",
  "created_at": "2026-11-02T10:15:00Z",
  "token": "4p3xl8eq9ao5swi5wb"
}
```

## The Shared launch object

A launch another account has shared with the caller, as seen by the beneficiary.

- `grant_id` (string): ID of the caller's grant on the launch.
- `launch_ext_id` (integer): The launch `ext_id`.
- `chain` (string): Chain ID of the launch.
- `owner` (string | null): Username of the launch owner. Never its license key.
- `owner_display_name` (string | null): Display name of the owner.
- `effective_operations` (array<string>): Operations left once every grant in the chain is applied.
- `effective_export_keys` (array<object>): [Wallet references](#object-wallet-reference) the caller may export.
- `allow_future_wallets` (boolean): Whether wallets added later are covered.
- `withdraw_destinations` (array<object>): Allowed withdraw destinations, each `{ chain, address }`.
- `expires_at` (string | null): ISO 8601 expiry, or `null`.
- `catalog_version` (integer): Catalog version that expanded the grant.
- `version` (integer): Grant revision number.
- `name` (string | null): Token name.
- `symbol` (string | null): Token symbol.
- `image_url` (string | null): Token image URL.
- `mint_pubkey` (string | null): Token mint or contract address.
- `launch_platform` (string | null): Launchpad the token is deployed on.
- `launch_status` (string | null): Launch status.
- `created_at` (integer | null): Launch creation time in Unix seconds, matching an owned mint's `created_at`.
- `mint` (object | null): The same launch card `GET /license/get-mints-info` returns, so a shared launch renders like an owned one.

```json
{
  "grant_id": "a037996a-b1ed-4133-b495-3ba07c7249ad",
  "launch_ext_id": 101920010239643,
  "chain": "sol",
  "owner": "launchlab",
  "owner_display_name": "Launch Lab",
  "effective_operations": [
    "launch.read",
    "history.read",
    "trade.buy",
    "trade.sell",
    "automation.autosell"
  ],
  "effective_export_keys": [],
  "allow_future_wallets": false,
  "withdraw_destinations": [],
  "expires_at": "2026-12-01T00:00:00Z",
  "catalog_version": 2,
  "version": 3,
  "name": "Moon Otter",
  "symbol": "OTTER",
  "image_url": "https://cdn.example.com/tokens/otter.png",
  "mint_pubkey": "Fe7dTUwYvLw7znvXqijANZgztiDVWiE4J3cjDs6RiaZ",
  "launch_platform": "pumpfun",
  "launch_status": "Finalized",
  "created_at": 1793491200,
  "mint": null
}
```

## The Wallet reference object

Points at one wallet of a launch: the row that holds it plus its public address. Used in grants and invites to name wallets the grantee may use, spend from or export.

- `kind` (enum): Wallet family of the launch's chain. Possible values: `svm_wallet`, `evm_wallet`.
- `wallet_id` (integer): Row ID of the wallet, as listed by the shareable-wallets endpoint.
- `pubkey` (string | null): Public address of the wallet.

```json
{
  "kind": "svm_wallet",
  "wallet_id": 48213,
  "pubkey": "nAPGFAYA6VRUYnJcHLhs7UCVVFpB1SuBng9U1k1JRP8E"
}
```

### Retrieve the permission catalog

`GET /launch/shares/catalog`

Returns every permission identifier a grant can carry, with the routes each one opens. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: allowed.
- Retry: Safe to retry.

The web app builds its access presets and the custom-permissions picker from this list instead of a list of its own. Identifiers are append-only, so the app caches the catalog for the whole session.

#### Returns 200 OK

- `ok` (boolean): Always `true`.
- `catalog_version` (integer): Current catalog version.
- `operations` (array<object>): Every permission identifier.
  - `id` (string): Permission identifier, e.g. `trade.buy`.
  - `high_risk` (boolean): Whether the operation moves assets out, exports a key or widens access.
  - `touches_wallets` (boolean): Whether the operation signs with or changes the launch's wallets.
  - `in_all` (boolean): Whether `operations: "all"` expands to it. `access.manage`, `wallet.shared_spend` and `launch.reveal_key` never do.
- `routes` (array<object>): Routes a grant can open.
  - `method` (string): HTTP method.
  - `pattern` (string): Route pattern.
  - `operation` (string | null): Permission that opens the route.
  - `risk` (enum): Risk class of the route. Possible values: `read`, `mutation`, `high_risk`.

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/shares/catalog" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "catalog_version": 2,
  "operations": [
    {
      "id": "launch.read",
      "high_risk": false,
      "touches_wallets": false,
      "in_all": true
    },
    {
      "id": "trade.buy",
      "high_risk": false,
      "touches_wallets": true,
      "in_all": true
    },
    {
      "id": "launch.reveal_key",
      "high_risk": true,
      "touches_wallets": false,
      "in_all": false
    },
    {
      "id": "access.manage",
      "high_risk": true,
      "touches_wallets": false,
      "in_all": false
    }
  ],
  "routes": [
    {
      "method": "GET",
      "pattern": "/history/launch/{ext_id}",
      "operation": "history.read",
      "risk": "read"
    }
  ]
}
```

### List shareable wallets

`GET /launch/shares/{launch_id}/resources`

Lists the launch's wallets so a grantor can pick which ones a grant may use or export. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: allowed.
- Retry: Safe to retry.

Used by the invite form to fill the wallet pickers. The response never contains a secret.

#### Path parameters

- `launch_id` (string, required): The launch `ext_id` (15 digits, chain-encoded).

#### Returns 200 OK

- `ok` (boolean): Always `true`.
- `wallets` (array<object>): Wallets the launch holds.
  - `kind` (enum): Wallet family. Possible values: `svm_wallet`, `evm_wallet`.
  - `wallet_id` (integer): Row ID to use in a [wallet reference](#object-wallet-reference).
  - `pubkey` (string): Public address.
  - `role` (enum): Role of the wallet in the launch. Possible values: `dev`, `funder`, `launch`.
  - `shared` (boolean): Whether the wallet also serves outside this launch. Spending it needs `wallet.shared_spend`.
  - `exportable` (boolean): Whether its secret can be exported on the owner's tier.
  - `in_my_grant` (boolean): For a delegate: whether the caller's own grant covers the wallet.
  - `i_may_share_export` (boolean): Whether the caller may pass on export of this wallet's key.
- `sub_keys_exportable` (boolean): Whether launch sub-keys can be exported on the owner's tier.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | The launch ID is not a valid `ext_id`. | Pass the 15-digit launch `ext_id`. |
| 403 | `forbidden` | `only the user this license is associated with can manage its shares` | The session's user is not the user the license is associated with. | Sign in as the user the license is associated with. |
| 403 | `forbidden` | `this share does not carry 'access.manage'` | The caller reaches the launch through a share that does not carry `access.manage`. | Ask the owner to add `access.manage` to your grant. |
| 404 | `not_found` | `launch not found` | The launch does not exist, or the caller neither owns it nor holds a live share on it. | Check the `ext_id` against your own launches and [List launches shared with you](/reference/launch-sharing/#list-shared-launches). |
| 422 | `unprocessable` | `a multi-launch container cannot be shared; share its member launches` | The launch is a multi-launch container, which cannot be shared. | Share each member launch instead. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/shares/101920010239643/resources" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "wallets": [
    {
      "kind": "svm_wallet",
      "wallet_id": 48213,
      "pubkey": "nAPGFAYA6VRUYnJcHLhs7UCVVFpB1SuBng9U1k1JRP8E",
      "role": "dev",
      "shared": false,
      "exportable": true,
      "in_my_grant": false,
      "i_may_share_export": true
    },
    {
      "kind": "svm_wallet",
      "wallet_id": 48190,
      "pubkey": "P3LTQ8mab78Ao4EKHt7QTEncNchS5HWLNf78hLVp8Hj",
      "role": "funder",
      "shared": true,
      "exportable": false,
      "in_my_grant": false,
      "i_may_share_export": false
    }
  ],
  "sub_keys_exportable": false
}
```

### List grants on a launch

`GET /launch/shares/{launch_id}`

Lists the grants on a launch: the whole tree for the owner, the caller's own branch for a delegate. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: allowed.
- Retry: Safe to retry.

Feeds the member list of the Collaborate modal and the team avatars on the launch page.

#### Path parameters

- `launch_id` (string, required): The launch `ext_id`.

#### Returns 200 OK

Returns a list of [Grant](#object-grant) objects.

- `ok` (boolean): Always `true`.
- `grants` (array<object>): [Grant](#object-grant) objects.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | The launch ID is not a valid `ext_id`. | Pass the 15-digit launch `ext_id`. |
| 403 | `forbidden` | `only the user this license is associated with can manage its shares` | The session's user is not the user the license is associated with. | Sign in as the user the license is associated with. |
| 403 | `forbidden` | `this share does not carry 'access.manage'` | The caller reaches the launch through a share that does not carry `access.manage`. | Ask the owner to add `access.manage` to your grant. |
| 404 | `not_found` | `launch not found` | The launch does not exist, or the caller neither owns it nor holds a live share on it. | Check the `ext_id` against your own launches and [List launches shared with you](/reference/launch-sharing/#list-shared-launches). |
| 422 | `unprocessable` | `a multi-launch container cannot be shared; share its member launches` | The launch is a multi-launch container, which cannot be shared. | Share each member launch instead. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/shares/101920010239643" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "grants": [
    {
      "id": "a037996a-b1ed-4133-b495-3ba07c7249ad",
      "parent_grant_id": null,
      "version": 3,
      "catalog_version": 2,
      "launch_ext_id": 101920010239643,
      "chain": "sol",
      "depth": 0,
      "operations": [
        "launch.read",
        "history.read",
        "trade.buy",
        "trade.sell",
        "automation.autosell"
      ],
      "export_keys": [],
      "use_wallets": [
        {
          "kind": "svm_wallet",
          "wallet_id": 48213,
          "pubkey": "nAPGFAYA6VRUYnJcHLhs7UCVVFpB1SuBng9U1k1JRP8E"
        }
      ],
      "allow_future_wallets": false,
      "shared_spend_wallets": [],
      "constraints": {
        "withdraw_destinations": [],
        "max_new_wallets": null
      },
      "expires_at": "2026-12-01T00:00:00Z",
      "revoked_at": null,
      "created_at": "2026-11-02T10:15:00Z",
      "grantee": "demo-trader",
      "grantee_display_name": "Demo Trader",
      "grantee_avatar_url": null
    }
  ]
}
```

### Retrieve a grant

`GET /launch/shares/{launch_id}/{grant_id}`

Retrieves one grant with the effective rights of its whole chain. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: allowed.
- Retry: Safe to retry.

The response carries the `version` an update must send as `If-Match`, also returned in the `ETag` header, and the `effective_*` fields.

> Not called by the current web app.

#### Path parameters

- `launch_id` (string, required): The launch `ext_id`.
- `grant_id` (string, required): Grant ID (UUID).

#### Returns 200 OK

Returns a [Grant](#object-grant) object, including its `effective_*` fields.

- `ok` (boolean): Always `true`.
- `grant` (object): The [Grant](#object-grant).

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | The launch ID is not a valid `ext_id`. | Pass the 15-digit launch `ext_id`. |
| 403 | `forbidden` | `only the user this license is associated with can manage its shares` | The session's user is not the user the license is associated with. | Sign in as the user the license is associated with. |
| 403 | `forbidden` | `this share does not carry 'access.manage'` | The caller reaches the launch through a share that does not carry `access.manage`. | Ask the owner to add `access.manage` to your grant. |
| 404 | `not_found` | `grant not found` | No such grant on this launch, or it is outside the caller's branch. | Pick a grant ID from [List grants on a launch](/reference/launch-sharing/#list-grants). |
| 404 | `not_found` | `launch not found` | The launch does not exist, or the caller neither owns it nor holds a live share on it. | Check the `ext_id` against your own launches and [List launches shared with you](/reference/launch-sharing/#list-shared-launches). |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/shares/101920010239643/a037996a-b1ed-4133-b495-3ba07c7249ad" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "grant": {
    "id": "a037996a-b1ed-4133-b495-3ba07c7249ad",
    "parent_grant_id": null,
    "version": 3,
    "catalog_version": 2,
    "launch_ext_id": 101920010239643,
    "chain": "sol",
    "depth": 0,
    "operations": [
      "launch.read",
      "trade.buy"
    ],
    "export_keys": [],
    "use_wallets": [
      {
        "kind": "svm_wallet",
        "wallet_id": 48213,
        "pubkey": "nAPGFAYA6VRUYnJcHLhs7UCVVFpB1SuBng9U1k1JRP8E"
      }
    ],
    "allow_future_wallets": false,
    "shared_spend_wallets": [],
    "constraints": {
      "withdraw_destinations": [],
      "max_new_wallets": null
    },
    "expires_at": null,
    "revoked_at": null,
    "created_at": "2026-11-02T10:15:00Z",
    "grantee": "demo-trader",
    "grantee_display_name": "Demo Trader",
    "grantee_avatar_url": null,
    "effective_operations": [
      "launch.read",
      "trade.buy"
    ],
    "effective_export_keys": [],
    "effective_use_wallets": [
      {
        "kind": "svm_wallet",
        "wallet_id": 48213,
        "pubkey": "nAPGFAYA6VRUYnJcHLhs7UCVVFpB1SuBng9U1k1JRP8E"
      }
    ],
    "effective_allow_future_wallets": false,
    "effective_shared_spend_wallets": [],
    "effective_withdraw_destinations": []
  }
}
```

### Create an invite

`POST /launch/shares/{launch_id}/invites`

Opens a link or direct invite that carries the full configuration of the grant it will create. (Bearer JWT · 2FA step-up)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: refused with `403 read_only_token`.
- Two-factor: step-up for `launch.share` when the user protects it (`401 2fa_required`).
- Retry: Check before retrying. A repeated `link` invite opens a second link, and a repeated `direct` invite answers 409. Look for the invite in [List managed invites](/reference/launch-sharing/#list-managed-invites) first.

The configuration is checked against the caller's own rights before the invite is stored, so an invite can never name a right the grantor lacks. A `link` stays open for 24 hours and takes any number of clicks; each click files a request. A `direct` invite lands in the named account's incoming queue and waits up to 7 days.

`operations: "all"` is expanded at write time to every operation marked `in_all` in the catalog. Operations added to the catalog later need a new grant.

> A `direct` invite to a username that matches no account still answers `{ "ok": true }`, without `invite`, so the response never reveals whether a username exists.

> For the owner, a high-risk configuration (a high-risk operation, an exportable key, a shared spend wallet or `allow_future_wallets`) always asks for 2FA, whatever their settings, and is refused with 403 when they have no second factor. Any other configuration asks for 2FA when `launch.share` is protected, which it is by default once 2FA is on. The challenge is bound to the launch, the invite kind, the invitee and the exact rights. A delegate re-sharing the launch always answers a step-up.

#### Path parameters

- `launch_id` (string, required): The launch `ext_id`.

#### Body parameters

- `kind` (enum, required): Invite channel. A `request` is only ever filed by a link click. Possible values: `link`, `direct`.
- `username` (string, optional): Required for `direct`. The invitee's username, with or without a leading `@`.
- `operations` (array<string> | string, required): Permission identifiers from the catalog, or the string `all`.
- `export_keys` (array<object>, optional): [Wallet references](#object-wallet-reference) whose key the grantee may export.
- `use_wallets` (array<object>, optional): [Wallet references](#object-wallet-reference) the grantee may act on.
- `allow_future_wallets` (boolean, optional): Also cover wallets added to the launch later.
- `shared_spend_wallets` (array<object>, optional): [Wallet references](#object-wallet-reference) that serve outside this launch and may be spent from.
- `constraints` (object, optional): Limits on the grant.
  - `withdraw_destinations` (array<object>, optional): Allowed withdraw destinations, each `{ chain, address }`.
  - `max_new_wallets` (integer | null, optional): Cap on wallets the grantee may add.
- `expires_at` (string | null, optional): ISO 8601 expiry of the resulting grant. Omit or send `null` for no expiry. A past date is refused.

#### Returns 200 OK

Returns the created [Invite](#object-invite) object. A link invite includes its `token`.

- `ok` (boolean): Always `true`.
- `invite` (object): The [Invite](#object-invite). Absent when a direct invite names no existing account.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | The launch ID is not a valid `ext_id`. | Pass the 15-digit launch `ext_id`. |
| 400 | `bad_request` | `unknown invite kind '<kind>'` | `kind` is neither `link` nor `direct`. | Send `kind` as `link` or `direct`. |
| 400 | `bad_request` | `a direct invite needs a username` | A `direct` invite has no `username`. | Add the invitee's `username`, or send `kind: "link"`. |
| 400 | `bad_request` | `username must be 3-50 chars` | `username` is not a valid username: 3 to 50 letters, digits or hyphens, starting and ending with a letter or digit. | Send the invitee's username as shown on their profile, with or without the leading `@`. |
| 400 | `bad_request` | `unknown operation '<op>'` | `operations` names an identifier that is not in the catalog. | Use identifiers from [Retrieve the permission catalog](/reference/launch-sharing/#retrieve-catalog), or the string `all`. |
| 400 | `bad_request` | `a grant with no operation grants nothing` | `operations` is empty. | Name at least one operation. |
| 400 | `bad_request` | `that expiry is already past` | `expires_at` is not in the future. | Send a future `expires_at`, or `null` for no expiry. |
| 403 | `forbidden` | `only the user this license is associated with can manage its shares` | The session's user is not the user the license is associated with. | Sign in as the user the license is associated with. |
| 403 | `forbidden` | `this share does not carry 'access.manage'` | The caller reaches the launch through a share that does not carry `access.manage`. | Ask the owner to add `access.manage` to your grant. |
| 403 | `forbidden` | `you cannot pass on '<op>': your own share does not carry it` | A delegate names an operation its own share does not carry. | Remove the operation, or ask the owner to add it to your own grant. |
| 403 | `forbidden` | `acting on a shared launch needs two-factor authentication on your own account` | The configuration is high risk (a high-risk operation, an exportable key, a shared spend wallet or `allow_future_wallets`), or the caller is a delegate, and the caller has no second factor. | Turn on 2FA for your own account, starting with [Start TOTP enrollment](/reference/two-factor/#start-totp-enrollment). |
| 404 | `not_found` | `launch not found` | The launch does not exist or the caller cannot manage it. | Check the `ext_id` against your own launches and [List launches shared with you](/reference/launch-sharing/#list-shared-launches). |
| 409 | `conflict` | `that license already has a pending invite on this launch` | The invitee already has a pending invite or request on this launch. | Wait for the invitee to answer, or cancel the pending invite with [Revoke an invite](/reference/launch-sharing/#revoke-invite). |
| 422 | `unprocessable` | `a multi-launch container cannot be shared; share its member launches` | The launch is a multi-launch container, which cannot be shared. | Share each member launch instead. |
| 422 | `unprocessable` | `this launch already carries its maximum of invites` | The launch already has 100 live invites. | Cancel unused invites with [Revoke an invite](/reference/launch-sharing/#revoke-invite) first. |
| 422 | `unprocessable` | `you cannot invite yourself` | The `direct` invite names the caller. | Invite another account. |
| 422 | `unprocessable` | `the owner already holds this launch` | The `direct` invite names the launch owner. | Invite an account other than the owner. |
| 422 | `unprocessable` | `wallet reference <wallet_id> is not attached to this launch` | A wallet reference names a wallet the launch does not hold. | Pick wallets from [List shareable wallets](/reference/launch-sharing/#list-resources). |
| 422 | `unprocessable` | `the key of wallet <wallet_id> cannot be exported on the owner's tier` | `export_keys` names a wallet whose key cannot be exported on the owner's tier. | Only list wallets that [List shareable wallets](/reference/launch-sharing/#list-resources) marks `exportable`. |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/launch/shares/101920010239643/invites" \
  -H "Authorization: Bearer $PROXIMA_JWT" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "direct",
  "username": "@demo-trader",
  "operations": [
    "launch.read",
    "history.read",
    "trade.buy",
    "trade.sell",
    "automation.autosell"
  ],
  "use_wallets": [
    {
      "kind": "svm_wallet",
      "wallet_id": 48213,
      "pubkey": "nAPGFAYA6VRUYnJcHLhs7UCVVFpB1SuBng9U1k1JRP8E"
    }
  ],
  "export_keys": [],
  "allow_future_wallets": false,
  "shared_spend_wallets": [],
  "constraints": {
    "withdraw_destinations": []
  },
  "expires_at": "2026-12-01T00:00:00Z"
}'
```

#### Example response

```json
{
  "ok": true,
  "invite": {
    "id": "d71fa141-da50-4ffd-819e-a228f21db19c",
    "kind": "direct",
    "launch_ext_id": 101920010239643,
    "chain": "sol",
    "inviter": "launchlab",
    "inviter_display_name": "Launch Lab",
    "inviter_avatar_url": null,
    "invitee": "demo-trader",
    "invitee_display_name": "Demo Trader",
    "invitee_avatar_url": null,
    "name": "Moon Otter",
    "symbol": "OTTER",
    "image_url": "https://cdn.example.com/tokens/otter.png",
    "mint_pubkey": "Fe7dTUwYvLw7znvXqijANZgztiDVWiE4J3cjDs6RiaZ",
    "launch_platform": "pumpfun",
    "launch_status": "Finalized",
    "operations": [
      "launch.read",
      "history.read",
      "trade.buy",
      "trade.sell",
      "automation.autosell"
    ],
    "export_keys": [],
    "allow_future_wallets": false,
    "grant_expires_at": "2026-12-01T00:00:00Z",
    "max_uses": null,
    "uses_count": 0,
    "expires_at": "2026-11-09T10:15:00Z",
    "created_at": "2026-11-02T10:15:00Z"
  }
}
```

### List managed invites

`GET /launch/invites/managed`

Lists every live invite and request the caller can manage, across all of its launches. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: allowed.
- Retry: Safe to retry.

The web app polls this every 30 seconds for the bottom-bar invites menu, and filters it by `launch_ext_id` to show one launch's open invites and pending requests in the Collaborate modal.

#### Returns 200 OK

Returns a list of [Invite](#object-invite) objects. `token` is included only for launches the caller owns.

- `ok` (boolean): Always `true`.
- `invites` (array<object>): [Invite](#object-invite) objects of kind `link`, `direct` or `request`.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 403 | `forbidden` | `only the user this license is associated with can answer its invites` | The session's user is not the user the license is associated with. | Sign in as the user the license is associated with. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/invites/managed" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "invites": [
    {
      "id": "77ee5498-77c9-404b-8932-c95331fd86ce",
      "kind": "request",
      "launch_ext_id": 101920010239643,
      "chain": "sol",
      "inviter": "launchlab",
      "inviter_display_name": "Launch Lab",
      "inviter_avatar_url": null,
      "invitee": "otter-fan",
      "invitee_display_name": null,
      "invitee_avatar_url": null,
      "name": "Moon Otter",
      "symbol": "OTTER",
      "image_url": "https://cdn.example.com/tokens/otter.png",
      "mint_pubkey": "Fe7dTUwYvLw7znvXqijANZgztiDVWiE4J3cjDs6RiaZ",
      "launch_platform": "pumpfun",
      "launch_status": "Finalized",
      "operations": [
        "launch.read",
        "history.read"
      ],
      "export_keys": [],
      "allow_future_wallets": false,
      "grant_expires_at": null,
      "max_uses": null,
      "uses_count": 0,
      "expires_at": "2026-11-09T10:15:00Z",
      "created_at": "2026-11-02T10:15:00Z"
    }
  ]
}
```

### Revoke an invite

`DELETE /launch/shares/{launch_id}/invites/{invite_id}`

Cancels a link, revokes a pending direct invite, or declines a request. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: refused with `403 read_only_token`.
- Retry: Safe to retry. A repeat answers `revoked: false`.

#### Path parameters

- `launch_id` (string, required): The launch `ext_id`.
- `invite_id` (string, required): Invite ID (UUID).

#### Returns 200 OK

- `ok` (boolean): Always `true`.
- `revoked` (boolean): Whether the invite changed state.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | The launch ID is not a valid `ext_id`. | Pass the 15-digit launch `ext_id`. |
| 403 | `forbidden` | `only the user this license is associated with can manage its shares` | The session's user is not the user the license is associated with. | Sign in as the user the license is associated with. |
| 403 | `forbidden` | `this share does not carry 'access.manage'` | The caller reaches the launch through a share that does not carry `access.manage`. | Ask the owner to add `access.manage` to your grant. |
| 403 | `forbidden` | `acting on a shared launch needs two-factor authentication on your own account` | The caller is a delegate and has no second factor on their own account. | Turn on 2FA for your own account, starting with [Start TOTP enrollment](/reference/two-factor/#start-totp-enrollment). |
| 404 | `not_found` | `invite not found` | No such invite on this launch, or a delegate tried to revoke an invite it did not open. | Pick an invite ID from [List managed invites](/reference/launch-sharing/#list-managed-invites). |
| 404 | `not_found` | `launch not found` | The launch does not exist, or the caller neither owns it nor holds a live share on it. | Check the `ext_id` against your own launches and [List launches shared with you](/reference/launch-sharing/#list-shared-launches). |

#### Example request

```bash
curl -X DELETE "https://api-mig.proxima.tools/launch/shares/101920010239643/invites/d71fa141-da50-4ffd-819e-a228f21db19c" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "revoked": true
}
```

### Approve a join request

`POST /launch/shares/{launch_id}/invites/{invite_id}/approve`

Approves a request filed through a link and creates its grant. (Bearer JWT · 2FA step-up)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: refused with `403 read_only_token`.
- Two-factor: step-up for `launch.share` when the user protects it (`401 2fa_required`).
- Retry: Safe to retry. A repeat answers 409 once the grant exists; [List grants on a launch](/reference/launch-sharing/#list-grants) shows it.

The stored configuration is re-validated against the grantor's rights at this moment, so a right the grantor lost since the link was opened cannot be passed on. Because the link named no one, the owner confirms again here, bound to this request and the account it names.

> For the owner, 2FA follows the same rule as [Create an invite](/reference/launch-sharing/#create-invite): always for a high-risk configuration, otherwise as `launch.share` is set. The challenge is bound to this request and the account it names.

#### Path parameters

- `launch_id` (string, required): The launch `ext_id`.
- `invite_id` (string, required): ID of the `request` invite.

#### Returns 200 OK

- `ok` (boolean): Always `true`.
- `grant_id` (string): ID of the grant created.
- `launch_ext_id` (integer): The launch `ext_id`.
- `chain` (string): Chain ID of the launch.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | The launch ID is not a valid `ext_id`. | Pass the 15-digit launch `ext_id`. |
| 403 | `forbidden` | `only the user this license is associated with can manage its shares` | The session's user is not the user the license is associated with. | Sign in as the user the license is associated with. |
| 403 | `forbidden` | `this share does not carry 'access.manage'` | The caller reaches the launch through a share that does not carry `access.manage`. | Ask the owner to add `access.manage` to your grant. |
| 403 | `forbidden` | `acting on a shared launch needs two-factor authentication on your own account` | The request carries a high-risk configuration, or the caller is a delegate, and the caller has no second factor. | Turn on 2FA for your own account, starting with [Start TOTP enrollment](/reference/two-factor/#start-totp-enrollment). |
| 403 | `forbidden` | `the inviter no longer shares this launch` | The delegate who opened the link no longer holds a share on the launch. | Ask the owner to open a new link. |
| 403 | `forbidden` | `the inviter can no longer re-share this launch` | The delegate who opened the link lost `access.manage` since. | Ask the owner to open a new link. |
| 403 | `forbidden` | `you cannot pass on '<op>': your own share does not carry it` | The grantor lost an operation the request carries since the link was opened. | Remove the operation, or ask the owner to add it to your own grant. |
| 404 | `not_found` | `request not found` | No such request on this launch. | Pick a pending request from [List managed invites](/reference/launch-sharing/#list-managed-invites). |
| 404 | `not_found` | `launch not found` | The launch does not exist, or the caller neither owns it nor holds a live share on it. | Check the `ext_id` against your own launches and [List launches shared with you](/reference/launch-sharing/#list-shared-launches). |
| 409 | `conflict` | `this invite is no longer open` | The request was already approved, or was settled while the grant was being created. | Check [List grants on a launch](/reference/launch-sharing/#list-grants): the grant may already exist. |
| 409 | `conflict` | `this license already holds a grant on this launch` | The requester already holds a grant on this launch. | Change the existing grant with [Update a grant](/reference/launch-sharing/#update-grant) instead. |
| 422 | `unprocessable` | `this request is no longer open` | The request has expired. | Ask the account to request access again through a live link. |
| 422 | `unprocessable` | `this launch has changed hands, so the invite is stale` | The launch changed owner since the link was opened. | Open a new link from the current owner's account. |
| 422 | `unprocessable` | `this launch already carries its maximum of shares` | The launch already has 50 live grants. | Free a slot with [Revoke a grant](/reference/launch-sharing/#revoke-grant) first. |
| 422 | `unprocessable` | `that license already holds its maximum of shares` | The requester already holds 200 shares. | Ask the requester to leave a shared launch first. |
| 422 | `unprocessable` | `this chain of shares is already as deep as it goes` | The new grant would sit deeper in the chain of re-shares than allowed. | Have someone higher in the chain share the launch directly. |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/launch/shares/101920010239643/invites/77ee5498-77c9-404b-8932-c95331fd86ce/approve" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "grant_id": "c70deb57-52d2-445c-adbc-4b6052a08edb",
  "launch_ext_id": 101920010239643,
  "chain": "sol"
}
```

### Preview an invite link

`GET /launch/invites/link/{token}`

Returns the launch, inviter, rights and expiry behind an invite link. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: allowed.
- Retry: Safe to retry.

Backs the join page opened from `/invite/{token}`. When `already_member` is `true` the web app skips the request step and navigates straight to the launch. Requires a signed-in account.

#### Path parameters

- `token` (string, required): Link token from the invite URL.

#### Returns 200 OK

- `ok` (boolean): Always `true`.
- `already_member` (boolean): The caller already owns the launch or holds a grant on it.
- `invite` (object): The [Invite](#object-invite), without its `token`.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 404 | `not_found` | `this invite link is not valid` | The link is not valid. The web app shows the link as invalid. | Ask the inviter for a new link. |
| 422 | `unprocessable` | `this invite link has expired` | The link has expired or was cancelled. | Ask the inviter for a new link. |
| 429 | `too_many_requests` | `rate limit exceeded for invite_link, please retry later` | More than 20 link previews or link requests in a minute for this account. | Wait a minute before opening another link. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/invites/link/4p3xl8eq9ao5swi5wb" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "already_member": false,
  "invite": {
    "id": "d71fa141-da50-4ffd-819e-a228f21db19c",
    "kind": "link",
    "launch_ext_id": 101920010239643,
    "chain": "sol",
    "inviter": "launchlab",
    "inviter_display_name": "Launch Lab",
    "inviter_avatar_url": null,
    "invitee": null,
    "invitee_display_name": null,
    "invitee_avatar_url": null,
    "name": "Moon Otter",
    "symbol": "OTTER",
    "image_url": "https://cdn.example.com/tokens/otter.png",
    "mint_pubkey": "Fe7dTUwYvLw7znvXqijANZgztiDVWiE4J3cjDs6RiaZ",
    "launch_platform": "pumpfun",
    "launch_status": "Finalized",
    "operations": [
      "launch.read",
      "history.read",
      "trade.buy",
      "trade.sell"
    ],
    "export_keys": [],
    "allow_future_wallets": false,
    "grant_expires_at": null,
    "max_uses": null,
    "uses_count": 2,
    "expires_at": "2026-11-03T10:15:00Z",
    "created_at": "2026-11-02T10:15:00Z"
  }
}
```

### Request to join through a link

`POST /launch/invites/link/{token}/request`

Files a join request through an invite link, or reports that the caller is already a member. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: refused with `403 read_only_token`.
- Retry: Safe to retry. A repeat while the request is open files nothing new and answers `request_sent` again.

No grant is created here: the request waits for the grantor to approve it. A repeat click while a request is still open is a no-op and is reported as sent. On `already_member` the web app navigates to the launch.

#### Path parameters

- `token` (string, required): Link token from the invite URL.

#### Returns 200 OK

- `ok` (boolean): Always `true`.
- `status` (enum): Outcome of the click. Possible values: `request_sent`, `already_member`.
- `launch_ext_id` (integer): Only for `already_member`: the launch to open.
- `chain` (string): Only for `already_member`: chain ID of the launch.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 403 | `forbidden` | `only the user this license is associated with can answer its invites` | The session's user is not the user the license is associated with. | Sign in as the user the license is associated with. |
| 404 | `not_found` | `this invite link is not valid` | The link is not valid. | Ask the inviter for a new link. |
| 422 | `unprocessable` | `this invite link has expired` | The link has expired or was cancelled. | Ask the inviter for a new link. |
| 429 | `too_many_requests` | `rate limit exceeded for invite_link, please retry later` | More than 20 link previews or link requests in a minute for this account. | Wait a minute before opening another link. |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/launch/invites/link/4p3xl8eq9ao5swi5wb/request" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "status": "request_sent"
}
```

### List incoming invites

`GET /launch/invites/incoming`

Lists the direct invites addressed to the caller that are still pending. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: allowed.
- Retry: Safe to retry.

Polled every 60 seconds for the bottom-bar invites menu. Requests the caller filed through links are not included.

#### Returns 200 OK

Returns a list of [Invite](#object-invite) objects of kind `direct`.

- `ok` (boolean): Always `true`.
- `invites` (array<object>): [Invite](#object-invite) objects.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 403 | `forbidden` | `only the user this license is associated with can answer its invites` | The session's user is not the user the license is associated with. | Sign in as the user the license is associated with. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/invites/incoming" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "invites": [
    {
      "id": "d71fa141-da50-4ffd-819e-a228f21db19c",
      "kind": "direct",
      "launch_ext_id": 202752211705544,
      "chain": "base",
      "inviter": "launchlab",
      "inviter_display_name": "Launch Lab",
      "inviter_avatar_url": null,
      "invitee": "demo-trader",
      "invitee_display_name": "Demo Trader",
      "invitee_avatar_url": null,
      "name": "Base Heron",
      "symbol": "HERON",
      "image_url": null,
      "mint_pubkey": "0xb9767cbebeaa4406e61ea880017479efc18c0a76",
      "launch_platform": "clanker",
      "launch_status": "Finalized",
      "operations": [
        "launch.read",
        "history.read"
      ],
      "export_keys": [],
      "allow_future_wallets": false,
      "grant_expires_at": null,
      "max_uses": null,
      "uses_count": 0,
      "expires_at": "2026-11-09T10:15:00Z",
      "created_at": "2026-11-02T10:15:00Z"
    }
  ]
}
```

### Accept an invite

`POST /launch/invites/{invite_id}/accept`

Accepts a direct invite addressed to the caller and creates its grant. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: refused with `403 read_only_token`.
- Retry: Safe to retry. A repeat answers 422 once the grant exists; [List launches shared with you](/reference/launch-sharing/#list-shared-launches) shows it.

The stored configuration is re-validated against the grantor's rights at this moment before the grant is inserted.

#### Path parameters

- `invite_id` (string, required): ID of the direct invite.

#### Returns 200 OK

- `ok` (boolean): Always `true`.
- `grant_id` (string): ID of the grant created.
- `launch_ext_id` (integer): The launch `ext_id`.
- `chain` (string): Chain ID of the launch.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 403 | `forbidden` | `only the user this license is associated with can answer its invites` | The session's user is not the user the license is associated with. | Sign in as the user the license is associated with. |
| 403 | `forbidden` | `the inviter no longer shares this launch` | The delegate who sent the invite no longer holds a share on the launch. | Ask the owner for a new invite. |
| 403 | `forbidden` | `the inviter can no longer re-share this launch` | The delegate who sent the invite lost `access.manage` since. | Ask the owner for a new invite. |
| 403 | `forbidden` | `you cannot pass on '<op>': your own share does not carry it` | The inviter lost an operation the invite carries since it was sent. | Remove the operation, or ask the owner to add it to your own grant. |
| 404 | `not_found` | `invite not found` | No direct invite with this ID is addressed to the caller. | Pick an invite ID from [List incoming invites](/reference/launch-sharing/#list-incoming-invites). |
| 404 | `not_found` | `launch not found` | The launch no longer exists. | Check the `ext_id` against your own launches and [List launches shared with you](/reference/launch-sharing/#list-shared-launches). |
| 409 | `conflict` | `this invite is no longer open` | The invite was settled while the grant was being created. | Check [List launches shared with you](/reference/launch-sharing/#list-shared-launches): the grant may already exist. |
| 409 | `conflict` | `this license already holds a grant on this launch` | The caller already holds a grant on this launch. | Open the launch from [List launches shared with you](/reference/launch-sharing/#list-shared-launches). |
| 422 | `unprocessable` | `this invite is no longer open` | The invite was already answered or revoked, or has expired. | Ask the inviter for a new invite. |
| 422 | `unprocessable` | `this launch has changed hands, so the invite is stale` | The launch changed owner since the invite was created. | Ask the current owner for a new invite. |
| 422 | `unprocessable` | `this launch already carries its maximum of shares` | The launch already has 50 live grants. | Free a slot with [Revoke a grant](/reference/launch-sharing/#revoke-grant) first. |
| 422 | `unprocessable` | `that license already holds its maximum of shares` | The caller already holds 200 shares. | Free a slot with [Leave a shared launch](/reference/launch-sharing/#leave-shared-launch) first. |
| 422 | `unprocessable` | `this chain of shares is already as deep as it goes` | The new grant would sit deeper in the chain of re-shares than allowed. | Have someone higher in the chain share the launch directly. |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/launch/invites/d71fa141-da50-4ffd-819e-a228f21db19c/accept" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "grant_id": "1db9300d-7675-4ea9-b059-f55926850b1c",
  "launch_ext_id": 202752211705544,
  "chain": "base"
}
```

### Decline an invite

`POST /launch/invites/{invite_id}/decline`

Refuses a direct invite addressed to the caller. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: refused with `403 read_only_token`.
- Retry: Safe to retry. A repeat answers 422 once the invite is declined.

#### Path parameters

- `invite_id` (string, required): ID of the direct invite.

#### Returns 200 OK

- `ok` (boolean): Always `true`.
- `declined` (boolean): Whether the invite changed state.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 403 | `forbidden` | `only the user this license is associated with can answer its invites` | The session's user is not the user the license is associated with. | Sign in as the user the license is associated with. |
| 404 | `not_found` | `invite not found` | No direct invite with this ID is addressed to the caller. | Pick an invite ID from [List incoming invites](/reference/launch-sharing/#list-incoming-invites). |
| 422 | `unprocessable` | `this invite is no longer open` | The invite was already answered or revoked, or has expired. | Nothing to do: the invite can no longer be accepted. |

#### Example request

```bash
curl -X POST "https://api-mig.proxima.tools/launch/invites/d71fa141-da50-4ffd-819e-a228f21db19c/decline" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "declined": true
}
```

### Update a grant

`PATCH /launch/shares/{launch_id}/{grant_id}`

Replaces a grant's rights as a whole, guarded by the grant version. (Bearer JWT · 2FA step-up)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: refused with `403 read_only_token`.
- Two-factor: step-up when the user protects it (`401 2fa_required`).
- Retry: Safe to retry. `If-Match` makes a repeat answer 409 once the first call applied; read the grant again with [Retrieve a grant](/reference/launch-sharing/#retrieve-grant).

The body replaces every right of the grant; omitted lists become empty. Every descendant grant is clamped onto what is left in the same transaction.

The SDK sends the `version` it read as `If-Match`, so an edit based on a stale read is refused instead of overwriting a change made since.

> When the owner widens the grant (new operations, new exportable keys, new shared spend wallets, or `allow_future_wallets` turned on), 2FA is always asked, whatever the `launch.share` setting, and the call is refused with 403 when the owner has no second factor. A delegate always answers a step-up.

> Reducing rights stops new actions only. A strategy or withdrawal already armed under the grant keeps running until it is stopped on its own route.

#### Path parameters

- `launch_id` (string, required): The launch `ext_id`.
- `grant_id` (string, required): Grant ID (UUID).

#### Headers

- `If-Match` (integer, required): The grant `version` the edit is based on.

#### Body parameters

- `operations` (array<string> | string, required): Permission identifiers, or the string `all`.
- `export_keys` (array<object>, optional): [Wallet references](#object-wallet-reference) whose key may be exported.
- `use_wallets` (array<object>, optional): [Wallet references](#object-wallet-reference) the grantee may act on.
- `allow_future_wallets` (boolean, optional): Also cover wallets added later.
- `shared_spend_wallets` (array<object>, optional): [Wallet references](#object-wallet-reference) that serve outside this launch and may be spent from.
- `constraints` (object, optional): Limits on the grant.
  - `withdraw_destinations` (array<object>, optional): Allowed withdraw destinations, each `{ chain, address }`.
  - `max_new_wallets` (integer | null, optional): Cap on wallets the grantee may add.
- `expires_at` (string | null, optional): ISO 8601 expiry, or `null` for none. A past date is refused.

#### Returns 200 OK

Returns the updated [Grant](#object-grant) object.

- `ok` (boolean): Always `true`.
- `grant` (object): The updated [Grant](#object-grant), with its new `version`.
- `descendants_clamped` (integer): Number of descendant grants reduced to fit.
- `note` (string): Reminder that jobs already running keep the wallets they captured.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | The launch ID is not a valid `ext_id`. | Pass the 15-digit launch `ext_id`. |
| 400 | `bad_request` | `If-Match must carry the grant version you read` | `If-Match` is missing or is not an integer. | Send the `version` from [Retrieve a grant](/reference/launch-sharing/#retrieve-grant) as `If-Match`. |
| 400 | `bad_request` | `unknown operation '<op>'` | `operations` names an identifier that is not in the catalog. | Use identifiers from [Retrieve the permission catalog](/reference/launch-sharing/#retrieve-catalog), or the string `all`. |
| 400 | `bad_request` | `that expiry is already past` | `expires_at` is not in the future. | Send a future `expires_at`, or `null` for no expiry. |
| 403 | `forbidden` | `only the user this license is associated with can manage its shares` | The session's user is not the user the license is associated with. | Sign in as the user the license is associated with. |
| 403 | `forbidden` | `this share does not carry 'access.manage'` | The caller reaches the launch through a share that does not carry `access.manage`. | Ask the owner to add `access.manage` to your grant. |
| 403 | `forbidden` | `you cannot pass on '<op>': your own share does not carry it` | A delegate names an operation its own share does not carry. | Remove the operation, or ask the owner to add it to your own grant. |
| 403 | `forbidden` | `you cannot pass on wallet <wallet_id> : your own share does not carry it` | A delegate names a wallet its own share does not cover. | Remove the wallet, or ask the owner to add it to your own grant. |
| 403 | `forbidden` | `acting on a shared launch needs two-factor authentication on your own account` | The owner widens the grant, or the caller is a delegate, and the caller has no second factor. | Turn on 2FA for your own account, starting with [Start TOTP enrollment](/reference/two-factor/#start-totp-enrollment). |
| 404 | `not_found` | `grant not found` | No such grant on this launch, or it is outside the caller's branch. | Pick a grant ID from [List grants on a launch](/reference/launch-sharing/#list-grants). |
| 404 | `not_found` | `launch not found` | The launch does not exist, or the caller neither owns it nor holds a live share on it. | Check the `ext_id` against your own launches and [List launches shared with you](/reference/launch-sharing/#list-shared-launches). |
| 409 | `conflict` | `grant version is stale` | The grant changed since the version sent in `If-Match` was read. | Read the grant again with [Retrieve a grant](/reference/launch-sharing/#retrieve-grant) and reapply the change. |
| 422 | `unprocessable` | `wallet reference <wallet_id> is not attached to this launch` | A wallet reference names a wallet the launch does not hold. | Pick wallets from [List shareable wallets](/reference/launch-sharing/#list-resources). |

#### Example request

```bash
curl -X PATCH "https://api-mig.proxima.tools/launch/shares/101920010239643/a037996a-b1ed-4133-b495-3ba07c7249ad" \
  -H "Authorization: Bearer $PROXIMA_JWT" \
  -H "Content-Type: application/json" \
  -d '{
  "operations": [
    "launch.read",
    "history.read",
    "trade.sell"
  ],
  "export_keys": [],
  "use_wallets": [
    {
      "kind": "svm_wallet",
      "wallet_id": 48213,
      "pubkey": "nAPGFAYA6VRUYnJcHLhs7UCVVFpB1SuBng9U1k1JRP8E"
    }
  ],
  "allow_future_wallets": false,
  "shared_spend_wallets": [],
  "constraints": {
    "withdraw_destinations": []
  },
  "expires_at": "2026-12-01T00:00:00Z"
}'
```

#### Example response

```json
{
  "ok": true,
  "grant": {
    "id": "a037996a-b1ed-4133-b495-3ba07c7249ad",
    "parent_grant_id": null,
    "version": 4,
    "catalog_version": 2,
    "launch_ext_id": 101920010239643,
    "chain": "sol",
    "depth": 0,
    "operations": [
      "launch.read",
      "history.read",
      "trade.sell"
    ],
    "export_keys": [],
    "use_wallets": [
      {
        "kind": "svm_wallet",
        "wallet_id": 48213,
        "pubkey": "nAPGFAYA6VRUYnJcHLhs7UCVVFpB1SuBng9U1k1JRP8E"
      }
    ],
    "allow_future_wallets": false,
    "shared_spend_wallets": [],
    "constraints": {
      "withdraw_destinations": [],
      "max_new_wallets": null
    },
    "expires_at": "2026-12-01T00:00:00Z",
    "revoked_at": null,
    "created_at": "2026-11-02T10:15:00Z"
  },
  "descendants_clamped": 0,
  "note": "a job already armed keeps the wallets it captured; stop it to reduce what it can still spend"
}
```

### Revoke a grant

`DELETE /launch/shares/{launch_id}/{grant_id}`

Revokes a grant and every grant re-shared under it. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: refused with `403 read_only_token`.
- Retry: Safe to retry. A repeat answers `revoked: 0`.

Idempotent. Strategies and withdrawals already accepted under the grant keep running; stop them on their own routes.

#### Path parameters

- `launch_id` (string, required): The launch `ext_id`.
- `grant_id` (string, required): Grant ID (UUID).

#### Returns 200 OK

- `ok` (boolean): Always `true`.
- `revoked` (integer): Number of grants revoked, including descendants.
- `note` (string): Reminder that running jobs are not stopped.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | The launch ID is not a valid `ext_id`. | Pass the 15-digit launch `ext_id`. |
| 403 | `forbidden` | `only the user this license is associated with can manage its shares` | The session's user is not the user the license is associated with. | Sign in as the user the license is associated with. |
| 403 | `forbidden` | `this share does not carry 'access.manage'` | The caller reaches the launch through a share that does not carry `access.manage`. | Ask the owner to add `access.manage` to your grant. |
| 403 | `forbidden` | `acting on a shared launch needs two-factor authentication on your own account` | The caller is a delegate and has no second factor on their own account. | Turn on 2FA for your own account, starting with [Start TOTP enrollment](/reference/two-factor/#start-totp-enrollment). |
| 404 | `not_found` | `grant not found` | No such grant on this launch, or it is outside the caller's branch. | Pick a grant ID from [List grants on a launch](/reference/launch-sharing/#list-grants). |
| 404 | `not_found` | `launch not found` | The launch does not exist, or the caller neither owns it nor holds a live share on it. | Check the `ext_id` against your own launches and [List launches shared with you](/reference/launch-sharing/#list-shared-launches). |

#### Example request

```bash
curl -X DELETE "https://api-mig.proxima.tools/launch/shares/101920010239643/a037996a-b1ed-4133-b495-3ba07c7249ad" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "revoked": 2,
  "note": "strategies and withdrawals already accepted keep running; stop them on their own routes"
}
```

### List a grant's jobs

`GET /launch/shares/{launch_id}/{grant_id}/jobs`

Lists what a grant left running on the launch and the trace of what it did. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: allowed.
- Retry: Safe to retry.

Owner only. Shown as **Running jobs** in the Collaborate modal, so the owner can see and stop automations a grantee started.

#### Path parameters

- `launch_id` (string, required): The launch `ext_id`.
- `grant_id` (string, required): Grant ID (UUID).

#### Returns 200 OK

- `ok` (boolean): Always `true`.
- `jobs` (array<object>): Jobs started under the grant, newest first within each kind.
  - `kind` (string): Job kind: `autosell`, `autobuy`, `volume`, `cleanup` or `withdraw`; `market_maker` on Solana, `sniper_guard` on EVM chains.
  - `id` (string): Job ID (UUID). Use it on the job's own route to read or stop it.
  - `status` (string): Job status, as stored for its kind, e.g. `running`.
  - `created_at` (string): Creation time. ISO 8601: without a time zone (UTC) for sessions, with one for withdrawals.
- `trace` (array<object>): Recorded actions taken under the grant.
- `note` (string): Reminder that revoking the grant does not stop a job.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | The launch ID is not a valid `ext_id`. | Pass the 15-digit launch `ext_id`. |
| 403 | `forbidden` | `only the user this license is associated with can manage its shares` | The session's user is not the user the license is associated with. | Sign in as the user the license is associated with. |
| 404 | `not_found` | `grant not found` | No such grant on this launch. | Pick a grant ID from [List grants on a launch](/reference/launch-sharing/#list-grants). |
| 404 | `not_found` | `launch not found` | The launch does not exist or the caller is not its owner. Delegates get this answer too. | Call this endpoint from the owner's account. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/shares/101920010239643/a037996a-b1ed-4133-b495-3ba07c7249ad/jobs" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "jobs": [
    {
      "kind": "autosell",
      "id": "0f4e1ab4-5ba8-41eb-80ff-53eb97f08f2a",
      "status": "running",
      "created_at": "2026-11-02T09:58:12"
    }
  ],
  "trace": [],
  "note": "stop a job on its own strategy route; revoking the grant does not stop it"
}
```

### Check ownership transfer

`GET /launch/shares/{launch_id}/transfer-check`

Reports whether the launch can change owner right now. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: allowed.
- Retry: Safe to retry.

Owner only. A transfer is blocked while a job started under a grant is still signing on the launch.

> Not called by the current web app.

#### Path parameters

- `launch_id` (string, required): The launch `ext_id`.

#### Returns 200 OK

- `ok` (boolean): Always `true`.
- `may_transfer` (boolean): Whether ownership can change now.
- `reason` (string | null): Why a transfer is blocked, or `null`.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 400 | `bad_request` | `invalid launch id format` | The launch ID is not a valid `ext_id`. | Pass the 15-digit launch `ext_id`. |
| 403 | `forbidden` | `only the user this license is associated with can manage its shares` | The session's user is not the user the license is associated with. | Sign in as the user the license is associated with. |
| 403 | `forbidden` | `this share does not carry 'access.manage'` | The caller reaches the launch through a share that does not carry `access.manage`. | Ask the owner to add `access.manage` to your grant. |
| 404 | `not_found` | `launch not found` | The launch does not exist or the caller is not its owner. Delegates get this answer too. | Call this endpoint from the owner's account. |
| 422 | `unprocessable` | `a multi-launch container cannot be shared; share its member launches` | The launch is a multi-launch container, which cannot be shared. | Share each member launch instead. |

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/shares/101920010239643/transfer-check" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "may_transfer": false,
  "reason": "a delegated job is still signing on this launch"
}
```

### List launches shared with you

`GET /launch/shared`

Lists the launches other accounts have shared with the caller. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: allowed.
- Retry: Safe to retry.

The web app merges these into the launch list and search, and uses them to decide access on a launch page.

> The web app sends no paging parameters; the backend then returns at most 50 entries.

#### Returns 200 OK

Returns a list of [Shared launch](#object-shared-launch) objects.

- `ok` (boolean): Always `true`.
- `shared` (array<object>): [Shared launch](#object-shared-launch) objects.

#### Example request

```bash
curl "https://api-mig.proxima.tools/launch/shared" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "shared": [
    {
      "grant_id": "a037996a-b1ed-4133-b495-3ba07c7249ad",
      "launch_ext_id": 101920010239643,
      "chain": "sol",
      "owner": "launchlab",
      "owner_display_name": "Launch Lab",
      "effective_operations": [
        "launch.read",
        "history.read",
        "trade.buy",
        "trade.sell"
      ],
      "effective_export_keys": [],
      "allow_future_wallets": false,
      "withdraw_destinations": [],
      "expires_at": null,
      "catalog_version": 2,
      "version": 3,
      "name": "Moon Otter",
      "symbol": "OTTER",
      "image_url": "https://cdn.example.com/tokens/otter.png",
      "mint_pubkey": "Fe7dTUwYvLw7znvXqijANZgztiDVWiE4J3cjDs6RiaZ",
      "launch_platform": "pumpfun",
      "launch_status": "Finalized",
      "created_at": 1793491200,
      "mint": null
    }
  ]
}
```

### Leave a shared launch

`DELETE /launch/shared/{grant_id}`

Refuses the caller's own grant on a shared launch, revoking everything re-shared under it. (Bearer JWT)

- Token: Upgraded session token, bound to a license.
- Read-only tokens: refused with `403 read_only_token`.
- Retry: Safe to retry. A repeat answers `revoked: 0`.

Called from the shared-launch banner on a launch page.

#### Path parameters

- `grant_id` (string, required): ID of the caller's grant, from the shared-launch list.

#### Returns 200 OK

- `ok` (boolean): Always `true`.
- `revoked` (integer): Number of grants revoked, including descendants.

#### Errors

| Status | Code | Message | When | What to do |
| --- | --- | --- | --- | --- |
| 404 | `not_found` | `grant not found` | No such grant held by the caller. | Pick a grant ID from [List launches shared with you](/reference/launch-sharing/#list-shared-launches). |

#### Example request

```bash
curl -X DELETE "https://api-mig.proxima.tools/launch/shared/a037996a-b1ed-4133-b495-3ba07c7249ad" \
  -H "Authorization: Bearer $PROXIMA_JWT"
```

#### Example response

```json
{
  "ok": true,
  "revoked": 1
}
```
