Skip to content
API Reference

Search is only available in production builds. Try building and previewing the site to test it out locally.

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.

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.

Attributes

  • 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 whose secret key the grantee may export.
  • use_wallets array<object>
    Wallet references 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 that also serve outside this launch and that the grantee may spend from.
  • constraints object
    Limits attached to the grant.
    Child attributes 4
    • withdraw_destinations array<object>
      Addresses the grantee may withdraw to.
      Child attributes 2
      • 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.

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.

Attributes

  • id string
    Unique identifier (UUID).
  • kind enum
    link (open URL), direct (addressed to one username) or request (filed by a link click).
    Possible values linkdirectrequest
  • 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 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.

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

Attributes

  • 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 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.

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.

Attributes

  • kind enum
    Wallet family of the launch's chain.
    Possible values svm_walletevm_wallet
  • wallet_id integer
    Row ID of the wallet, as listed by the shareable-wallets endpoint.
  • pubkey string | null
    Public address of the wallet.
GET /launch/shares/catalog

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

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.

Parameters

No parameters.

Returns 200 OK · application/json

  • ok boolean
    Always true.
  • catalog_version integer
    Current catalog version.
  • operations array<object>
    Every permission identifier.
    Child attributes 4
    • 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.
    Child attributes 4
    • 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 readmutationhigh_risk

Errors

Only the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.

Web client proxima.launch.shares.getCatalog() src/lib/proxima/endpoints/launch/shares.ts

GET /launch/shares/{launch_id}/resources

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

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).
    Example101920010239643

Returns 200 OK · application/json

  • ok boolean
    Always true.
  • wallets array<object>
    Wallets the launch holds.
    Child attributes 8
    • kind enum
      Wallet family.
      Possible values svm_walletevm_wallet
    • wallet_id integer
      Row ID to use in a wallet reference.
    • pubkey string
      Public address.
    • role enum
      Role of the wallet in the launch.
      Possible values devfunderlaunch
    • 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

StatusCodeWhen and what to do
400 bad_request The launch ID is not a valid ext_id. Pass the 15-digit launch ext_id.
403 forbidden 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 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 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.
422 unprocessable The launch is a multi-launch container, which cannot be shared. Share each member launch instead.

Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.

Web client proxima.launch.shares.getResources(extId) src/lib/proxima/endpoints/launch/shares.ts

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.

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.
    Example101920010239643

Returns 200 OK · application/json

Returns a list of Grant objects.

  • ok boolean
    Always true.
  • grants array<object>
    Grant objects.

Errors

StatusCodeWhen and what to do
400 bad_request The launch ID is not a valid ext_id. Pass the 15-digit launch ext_id.
403 forbidden 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 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 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.
422 unprocessable The launch is a multi-launch container, which cannot be shared. Share each member launch instead.

Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.

Web client proxima.launch.shares.listGrants(extId) src/lib/proxima/endpoints/launch/shares.ts

Retrieve a grant

Bearer JWT
GET /launch/shares/{launch_id}/{grant_id}

Retrieves one grant with the effective rights of its whole chain.

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.

Path parameters

  • launch_id string Required
    The launch ext_id.
    Example101920010239643
  • grant_id string Required
    Grant ID (UUID).
    Examplea037996a-b1ed-4133-b495-3ba07c7249ad

Returns 200 OK · application/json

Returns a Grant object, including its effective_* fields.

  • ok boolean
    Always true.
  • grant object
    The Grant.

Errors

StatusCodeWhen and what to do
400 bad_request The launch ID is not a valid ext_id. Pass the 15-digit launch ext_id.
403 forbidden 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 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 No such grant on this launch, or it is outside the caller's branch. Pick a grant ID from List grants on a launch.
404 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.

Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.

Web client proxima.launch.shares.getGrant(extId, grantId) src/lib/proxima/endpoints/launch/shares.ts

Create an invite

Bearer JWT 2FA
POST /launch/shares/{launch_id}/invites

Opens a link or direct invite that carries the full configuration of the grant it will create.

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. How it works
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 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.

Path parameters

  • launch_id string Required
    The launch ext_id.
    Example101920010239643

Body parameters application/json

  • kind enum Required
    Invite channel. A request is only ever filed by a link click.
    Possible values linkdirect
  • 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 whose key the grantee may export.
  • use_wallets array<object> Optional
    Wallet references 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 that serve outside this launch and may be spent from.
  • constraints object Optional
    Limits on the grant.
    Child attributes 2
    • 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 · application/json

Returns the created Invite object. A link invite includes its token.

  • ok boolean
    Always true.
  • invite object
    The Invite. Absent when a direct invite names no existing account.

Errors

StatusCodeWhen and what to do
400 bad_request The launch ID is not a valid ext_id. Pass the 15-digit launch ext_id.
400 bad_request kind is neither link nor direct. Send kind as link or direct.
400 bad_request A direct invite has no username. Add the invitee's username, or send kind: "link".
400 bad_request 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 operations names an identifier that is not in the catalog. Use identifiers from Retrieve the permission catalog, or the string all.
400 bad_request operations is empty. Name at least one operation.
400 bad_request expires_at is not in the future. Send a future expires_at, or null for no expiry.
403 forbidden 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 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 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 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.
404 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.
409 conflict 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.
422 unprocessable The launch is a multi-launch container, which cannot be shared. Share each member launch instead.
422 unprocessable The launch already has 100 live invites. Cancel unused invites with Revoke an invite first.
422 unprocessable The direct invite names the caller. Invite another account.
422 unprocessable The direct invite names the launch owner. Invite an account other than the owner.
422 unprocessable A wallet reference names a wallet the launch does not hold. Pick wallets from List shareable wallets.
422 unprocessable export_keys names a wallet whose key cannot be exported on the owner's tier. Only list wallets that List shareable wallets marks exportable.

Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token, 401 2fa_required and 429 when rate limited.

Web client proxima.launch.shares.createInvite(extId, body) src/lib/proxima/endpoints/launch/shares.ts

GET /launch/invites/managed

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

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.

Parameters

No parameters.

Returns 200 OK · application/json

Returns a list of Invite objects. token is included only for launches the caller owns.

  • ok boolean
    Always true.
  • invites array<object>
    Invite objects of kind link, direct or request.

Errors

StatusCodeWhen and what to do
403 forbidden The session's user is not the user the license is associated with. Sign in as the user the license is associated with.

Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.

Web client proxima.launch.shares.listManagedInvites() src/lib/proxima/endpoints/launch/shares.ts

Revoke an invite

Bearer JWT
DEL /launch/shares/{launch_id}/invites/{invite_id}

Cancels a link, revokes a pending direct invite, or declines a request.

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.
    Example101920010239643
  • invite_id string Required
    Invite ID (UUID).
    Exampled71fa141-da50-4ffd-819e-a228f21db19c

Returns 200 OK · application/json

  • ok boolean
    Always true.
  • revoked boolean
    Whether the invite changed state.

Errors

StatusCodeWhen and what to do
400 bad_request The launch ID is not a valid ext_id. Pass the 15-digit launch ext_id.
403 forbidden 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 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 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.
404 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.
404 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.

Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.

Web client proxima.launch.shares.revokeInvite(extId, inviteId) src/lib/proxima/endpoints/launch/shares.ts

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

Approves a request filed through a link and creates its grant.

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. How it works
Retry
Safe to retry A repeat answers 409 once the grant exists; List grants on a launch 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.

Path parameters

  • launch_id string Required
    The launch ext_id.
    Example101920010239643
  • invite_id string Required
    ID of the request invite.
    Example77ee5498-77c9-404b-8932-c95331fd86ce

Returns 200 OK · application/json

  • 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

StatusCodeWhen and what to do
400 bad_request The launch ID is not a valid ext_id. Pass the 15-digit launch ext_id.
403 forbidden 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 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 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.
403 forbidden 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 delegate who opened the link lost access.manage since. Ask the owner to open a new link.
403 forbidden 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 No such request on this launch. Pick a pending request from List managed invites.
404 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.
409 conflict The request was already approved, or was settled while the grant was being created. Check List grants on a launch: the grant may already exist.
409 conflict The requester already holds a grant on this launch. Change the existing grant with Update a grant instead.
422 unprocessable The request has expired. Ask the account to request access again through a live link.
422 unprocessable The launch changed owner since the link was opened. Open a new link from the current owner's account.
422 unprocessable The launch already has 50 live grants. Free a slot with Revoke a grant first.
422 unprocessable The requester already holds 200 shares. Ask the requester to leave a shared launch first.
422 unprocessable The new grant would sit deeper in the chain of re-shares than allowed. Have someone higher in the chain share the launch directly.

Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token, 401 2fa_required and 429 when rate limited.

Web client proxima.launch.shares.approveRequest(extId, inviteId) src/lib/proxima/endpoints/launch/shares.ts

GET /launch/invites/incoming

Lists the direct invites addressed to the caller that are still pending.

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.

Parameters

No parameters.

Returns 200 OK · application/json

Returns a list of Invite objects of kind direct.

  • ok boolean
    Always true.
  • invites array<object>
    Invite objects.

Errors

StatusCodeWhen and what to do
403 forbidden The session's user is not the user the license is associated with. Sign in as the user the license is associated with.

Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.

Web client proxima.launch.shares.listIncomingInvites() src/lib/proxima/endpoints/launch/shares.ts

Accept an invite

Bearer JWT
POST /launch/invites/{invite_id}/accept

Accepts a direct invite addressed to the caller and creates its grant.

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 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.
    Exampled71fa141-da50-4ffd-819e-a228f21db19c

Returns 200 OK · application/json

  • 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

StatusCodeWhen and what to do
403 forbidden 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 delegate who sent the invite no longer holds a share on the launch. Ask the owner for a new invite.
403 forbidden The delegate who sent the invite lost access.manage since. Ask the owner for a new invite.
403 forbidden 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 No direct invite with this ID is addressed to the caller. Pick an invite ID from List incoming invites.
404 not_found The launch no longer exists. Check the ext_id against your own launches and List launches shared with you.
409 conflict The invite was settled while the grant was being created. Check List launches shared with you: the grant may already exist.
409 conflict The caller already holds a grant on this launch. Open the launch from List launches shared with you.
422 unprocessable The invite was already answered or revoked, or has expired. Ask the inviter for a new invite.
422 unprocessable The launch changed owner since the invite was created. Ask the current owner for a new invite.
422 unprocessable The launch already has 50 live grants. Free a slot with Revoke a grant first.
422 unprocessable The caller already holds 200 shares. Free a slot with Leave a shared launch first.
422 unprocessable The new grant would sit deeper in the chain of re-shares than allowed. Have someone higher in the chain share the launch directly.

Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.

Web client proxima.launch.shares.acceptInvite(inviteId) src/lib/proxima/endpoints/launch/shares.ts

Decline an invite

Bearer JWT
POST /launch/invites/{invite_id}/decline

Refuses a direct invite addressed to the caller.

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.
    Exampled71fa141-da50-4ffd-819e-a228f21db19c

Returns 200 OK · application/json

  • ok boolean
    Always true.
  • declined boolean
    Whether the invite changed state.

Errors

StatusCodeWhen and what to do
403 forbidden 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 No direct invite with this ID is addressed to the caller. Pick an invite ID from List incoming invites.
422 unprocessable The invite was already answered or revoked, or has expired. Nothing to do: the invite can no longer be accepted.

Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.

Web client proxima.launch.shares.declineInvite(inviteId) src/lib/proxima/endpoints/launch/shares.ts

Update a grant

Bearer JWT 2FA
PATCH /launch/shares/{launch_id}/{grant_id}

Replaces a grant's rights as a whole, guarded by the grant version.

Token
Upgraded session token, bound to a license.
Read-only tokens
Refused with 403 read_only_token.
Two-factor
Step-up for the matching action when the user protects it. How it works
Retry
Safe to retry If-Match makes a repeat answer 409 once the first call applied; read the grant again with Retrieve a 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.

Path parameters

  • launch_id string Required
    The launch ext_id.
    Example101920010239643
  • grant_id string Required
    Grant ID (UUID).
    Examplea037996a-b1ed-4133-b495-3ba07c7249ad

Headers

  • If-Match integer Required
    The grant version the edit is based on.
    Example3

Body parameters application/json

  • operations array<string> | string Required
    Permission identifiers, or the string all.
  • export_keys array<object> Optional
    Wallet references whose key may be exported.
  • use_wallets array<object> Optional
    Wallet references the grantee may act on.
  • allow_future_wallets boolean Optional
    Also cover wallets added later.
  • shared_spend_wallets array<object> Optional
    Wallet references that serve outside this launch and may be spent from.
  • constraints object Optional
    Limits on the grant.
    Child attributes 2
    • 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 · application/json

Returns the updated Grant object.

  • ok boolean
    Always true.
  • grant object
    The updated 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

StatusCodeWhen and what to do
400 bad_request The launch ID is not a valid ext_id. Pass the 15-digit launch ext_id.
400 bad_request If-Match is missing or is not an integer. Send the version from Retrieve a grant as If-Match.
400 bad_request operations names an identifier that is not in the catalog. Use identifiers from Retrieve the permission catalog, or the string all.
400 bad_request expires_at is not in the future. Send a future expires_at, or null for no expiry.
403 forbidden 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 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 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 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 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.
404 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.
404 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.
409 conflict The grant changed since the version sent in If-Match was read. Read the grant again with Retrieve a grant and reapply the change.
422 unprocessable A wallet reference names a wallet the launch does not hold. Pick wallets from List shareable wallets.

Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token, 401 2fa_required and 429 when rate limited.

Web client proxima.launch.shares.patchGrant(extId, grantId, version, body) src/lib/proxima/endpoints/launch/shares.ts

Revoke a grant

Bearer JWT
DEL /launch/shares/{launch_id}/{grant_id}

Revokes a grant and every grant re-shared under it.

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.
    Example101920010239643
  • grant_id string Required
    Grant ID (UUID).
    Examplea037996a-b1ed-4133-b495-3ba07c7249ad

Returns 200 OK · application/json

  • ok boolean
    Always true.
  • revoked integer
    Number of grants revoked, including descendants.
  • note string
    Reminder that running jobs are not stopped.

Errors

StatusCodeWhen and what to do
400 bad_request The launch ID is not a valid ext_id. Pass the 15-digit launch ext_id.
403 forbidden 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 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 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.
404 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.
404 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.

Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.

Web client proxima.launch.shares.revokeGrant(extId, grantId) src/lib/proxima/endpoints/launch/shares.ts

List a grant's jobs

Bearer JWT
GET /launch/shares/{launch_id}/{grant_id}/jobs

Lists what a grant left running on the launch and the trace of what it did.

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.
    Example101920010239643
  • grant_id string Required
    Grant ID (UUID).
    Examplea037996a-b1ed-4133-b495-3ba07c7249ad

Returns 200 OK · application/json

  • ok boolean
    Always true.
  • jobs array<object>
    Jobs started under the grant, newest first within each kind.
    Child attributes 4
    • 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

StatusCodeWhen and what to do
400 bad_request The launch ID is not a valid ext_id. Pass the 15-digit launch ext_id.
403 forbidden 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 No such grant on this launch. Pick a grant ID from List grants on a launch.
404 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.

Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.

Web client proxima.launch.shares.getGrantJobs(extId, grantId) src/lib/proxima/endpoints/launch/shares.ts

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

Reports whether the launch can change owner right now.

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.

Path parameters

  • launch_id string Required
    The launch ext_id.
    Example101920010239643

Returns 200 OK · application/json

  • ok boolean
    Always true.
  • may_transfer boolean
    Whether ownership can change now.
  • reason string | null
    Why a transfer is blocked, or null.

Errors

StatusCodeWhen and what to do
400 bad_request The launch ID is not a valid ext_id. Pass the 15-digit launch ext_id.
403 forbidden 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 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 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 The launch is a multi-launch container, which cannot be shared. Share each member launch instead.

Also the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.

Web client proxima.launch.shares.transferCheck(extId) src/lib/proxima/endpoints/launch/shares.ts

GET /launch/shared

Lists the launches other accounts have shared with the caller.

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.

Parameters

No parameters.

Returns 200 OK · application/json

Returns a list of Shared launch objects.

  • ok boolean
    Always true.
  • shared array<object>
    Shared launch objects.

Errors

Only the common errors: 401 for a missing or expired session or a base token (license_required) and 429 when rate limited.

Web client proxima.launch.shares.listShared() src/lib/proxima/endpoints/launch/shares.ts

DEL /launch/shared/{grant_id}

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

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.
    Examplea037996a-b1ed-4133-b495-3ba07c7249ad

Returns 200 OK · application/json

  • ok boolean
    Always true.
  • revoked integer
    Number of grants revoked, including descendants.

Errors

StatusCodeWhen and what to do
404 not_found No such grant held by the caller. Pick a grant ID from List launches shared with you.

Also the common errors: 401 for a missing or expired session or a base token (license_required), 403 read_only_token and 429 when rate limited.

Web client proxima.launch.shares.refuseShared(grantId) src/lib/proxima/endpoints/launch/shares.ts