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.
- GET
/launch/shares/catalog - GET
/launch/shares/{launch_id}/resources - GET
/launch/shares/{launch_id} - GET
/launch/shares/{launch_id}/{grant_id} - POST
/launch/shares/{launch_id}/invites - GET
/launch/invites/managed - DEL
/launch/shares/{launch_id}/invites/{invite_id} - POST
/launch/shares/{launch_id}/invites/{invite_id}/approve - GET
/launch/invites/link/{token} - POST
/launch/invites/link/{token}/request - GET
/launch/invites/incoming - POST
/launch/invites/{invite_id}/accept - POST
/launch/invites/{invite_id}/decline - PATCH
/launch/shares/{launch_id}/{grant_id} - DEL
/launch/shares/{launch_id}/{grant_id} - GET
/launch/shares/{launch_id}/{grant_id}/jobs - GET
/launch/shares/{launch_id}/transfer-check - GET
/launch/shared - DEL
/launch/shared/{grant_id}
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.
Attributes
-
idstringUnique identifier (UUID). -
parent_grant_idstring | nullGrant this one was re-shared from.nullfor a grant issued by the owner. -
versionintegerRevision number. Send it asIf-Matchwhen updating the grant. -
catalog_versionintegerVersion of the permission catalog that expandedoperations. -
launch_ext_idintegerThe launchext_id. -
chainstringChain ID of the launch, e.g.solorbase. -
depthintegerPosition in the re-share chain.0for a grant issued by the owner. -
operationsarray<string>Permission identifiers the grant carries, e.g.launch.read,trade.buy. -
export_keysarray<object>Wallet references whose secret key the grantee may export. -
use_walletsarray<object>Wallet references the grantee may act on. -
allow_future_walletsbooleanWhether the grant also covers wallets added to the launch later. -
shared_spend_walletsarray<object>Wallet references that also serve outside this launch and that the grantee may spend from. -
constraintsobjectLimits attached to the grant.Child attributes 4
-
withdraw_destinationsarray<object>Addresses the grantee may withdraw to.Child attributes 2
-
chainstringChain ID of the destination. -
addressstringDestination address.
-
-
max_new_walletsinteger | nullCap on wallets the grantee may add.
-
-
expires_atstring | nullISO 8601 expiry.nullmeans the grant never expires. -
revoked_atstring | nullISO 8601 time the grant was revoked, ornull. -
created_atstringISO 8601 creation time. -
granteestring | nullUsername of the beneficiary. Never its license key. -
grantee_display_namestring | nullDisplay name of the beneficiary. -
grantee_avatar_urlstring | nullAvatar URL of the beneficiary. -
effective_operationsarray<string>Only on a single-grant read: operations left once every ancestor grant is applied. -
effective_export_keysarray<object>Only on a single-grant read: exportable wallets left across the chain. -
effective_use_walletsarray<object>Only on a single-grant read: usable wallets left across the chain. -
effective_allow_future_walletsbooleanOnly on a single-grant read: whether future wallets are covered across the chain. -
effective_shared_spend_walletsarray<object>Only on a single-grant read: shared-spend wallets left across the chain. -
effective_withdraw_destinationsarray<object>Only on a single-grant read: withdraw destinations left across the chain.
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.
Attributes
-
idstringUnique identifier (UUID). -
kindenumlink(open URL),direct(addressed to one username) orrequest(filed by a link click).Possible valueslinkdirectrequest -
launch_ext_idintegerThe launchext_id. -
chainstringChain ID of the launch. -
inviterstring | nullUsername of whoever sent the invite. -
inviter_display_namestring | nullDisplay name of the inviter. -
inviter_avatar_urlstring | nullAvatar URL of the inviter. -
inviteestring | nullUsername of the named invitee (direct) or of the requesting account (request). -
invitee_display_namestring | nullDisplay name of the invitee. -
invitee_avatar_urlstring | nullAvatar URL of the invitee. -
namestring | nullToken name of the launch. -
symbolstring | nullToken symbol of the launch. -
image_urlstring | nullToken image URL. -
mint_pubkeystring | nullToken mint or contract address. -
launch_platformstring | nullLaunchpad the token is deployed on. -
launch_statusstring | nullLaunch status, e.g.Draft,Staged,Pending,Finalized. -
operationsarray<string>Permission identifiers the resulting grant will carry. -
export_keysarray<object>Wallet references whose key the grant will let the grantee export. -
allow_future_walletsbooleanWhether the grant will cover wallets added later. -
grant_expires_atstring | nullISO 8601 expiry the resulting grant will carry. -
max_usesinteger | nullLegacy link cap.nullmeans unlimited, which every link now is. -
uses_countintegerNumber of requests a link has gathered. -
expires_atstringISO 8601 time the invite itself lapses. -
created_atstringISO 8601 creation time. -
tokenstringLink 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.
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.
Attributes
-
kindenumWallet family of the launch's chain.Possible valuessvm_walletevm_wallet -
wallet_idintegerRow ID of the wallet, as listed by the shareable-wallets endpoint. -
pubkeystring | nullPublic address of the wallet.
Retrieve the permission catalog
/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
-
okbooleanAlwaystrue. -
catalog_versionintegerCurrent catalog version. -
operationsarray<object>Every permission identifier.Child attributes 4
-
idstringPermission identifier, e.g.trade.buy. -
high_riskbooleanWhether the operation moves assets out, exports a key or widens access. -
touches_walletsbooleanWhether the operation signs with or changes the launch's wallets. -
in_allbooleanWhetheroperations: "all"expands to it.access.manage,wallet.shared_spendandlaunch.reveal_keynever do.
-
-
routesarray<object>Routes a grant can open.Child attributes 4
-
methodstringHTTP method. -
patternstringRoute pattern. -
operationstring | nullPermission that opens the route. -
riskenumRisk class of the route.Possible valuesreadmutationhigh_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
List shareable wallets
/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_idstring RequiredThe launchext_id(15 digits, chain-encoded).Example101920010239643
Returns 200 OK · application/json
-
okbooleanAlwaystrue. -
walletsarray<object>Wallets the launch holds.Child attributes 8
-
kindenumWallet family.Possible valuessvm_walletevm_wallet -
wallet_idintegerRow ID to use in a wallet reference. -
pubkeystringPublic address. -
roleenumRole of the wallet in the launch.Possible valuesdevfunderlaunch -
sharedbooleanWhether the wallet also serves outside this launch. Spending it needswallet.shared_spend. -
exportablebooleanWhether its secret can be exported on the owner's tier. -
in_my_grantbooleanFor a delegate: whether the caller's own grant covers the wallet. -
i_may_share_exportbooleanWhether the caller may pass on export of this wallet's key.
-
-
sub_keys_exportablebooleanWhether launch sub-keys can be exported on the owner's tier.
Errors
| Status | Code | When 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
List grants on a launch
/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_idstring RequiredThe launchext_id.Example101920010239643
Returns 200 OK · application/json
Returns a list of Grant objects.
-
okbooleanAlwaystrue. -
grantsarray<object>Grant objects.
Errors
| Status | Code | When 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
/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_idstring RequiredThe launchext_id.Example101920010239643 -
grant_idstring RequiredGrant ID (UUID).Examplea037996a-b1ed-4133-b495-3ba07c7249ad
Returns 200 OK · application/json
Returns a Grant object, including its effective_* fields.
-
okbooleanAlwaystrue. -
grantobjectThe Grant.
Errors
| Status | Code | When 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
/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.sharewhen the user protects it. How it works - Retry
- Check before retrying A repeated
linkinvite opens a second link, and a repeateddirectinvite 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_idstring RequiredThe launchext_id.Example101920010239643
Body parameters application/json
-
kindenum RequiredInvite channel. Arequestis only ever filed by a link click.Possible valueslinkdirect -
usernamestring OptionalRequired fordirect. The invitee's username, with or without a leading@. -
operationsarray<string> | string RequiredPermission identifiers from the catalog, or the stringall. -
export_keysarray<object> OptionalWallet references whose key the grantee may export. -
use_walletsarray<object> OptionalWallet references the grantee may act on. -
allow_future_walletsboolean OptionalAlso cover wallets added to the launch later. -
shared_spend_walletsarray<object> OptionalWallet references that serve outside this launch and may be spent from. -
constraintsobject OptionalLimits on the grant.Child attributes 2
-
withdraw_destinationsarray<object> OptionalAllowed withdraw destinations, each{ chain, address }. -
max_new_walletsinteger | null OptionalCap on wallets the grantee may add.
-
-
expires_atstring | null OptionalISO 8601 expiry of the resulting grant. Omit or sendnullfor no expiry. A past date is refused.
Returns 200 OK · application/json
Returns the created Invite object. A link invite includes its token.
-
okbooleanAlwaystrue. -
inviteobjectThe Invite. Absent when a direct invite names no existing account.
Errors
| Status | Code | When 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
List managed invites
/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.
-
okbooleanAlwaystrue. -
invitesarray<object>
Errors
| Status | Code | When 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
/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_idstring RequiredThe launchext_id.Example101920010239643 -
invite_idstring RequiredInvite ID (UUID).Exampled71fa141-da50-4ffd-819e-a228f21db19c
Returns 200 OK · application/json
-
okbooleanAlwaystrue. -
revokedbooleanWhether the invite changed state.
Errors
| Status | Code | When 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
Approve a join request
/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.sharewhen 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_idstring RequiredThe launchext_id.Example101920010239643 -
invite_idstring RequiredID of therequestinvite.Example77ee5498-77c9-404b-8932-c95331fd86ce
Returns 200 OK · application/json
-
okbooleanAlwaystrue. -
grant_idstringID of the grant created. -
launch_ext_idintegerThe launchext_id. -
chainstringChain ID of the launch.
Errors
| Status | Code | When 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
Preview an invite link
/launch/invites/link/{token} Returns the launch, inviter, rights and expiry behind an invite link.
- 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
-
tokenstring RequiredLink token from the invite URL.Example4p3xl8eq9ao5swi5wb
Returns 200 OK · application/json
-
okbooleanAlwaystrue. -
already_memberbooleanThe caller already owns the launch or holds a grant on it. -
inviteobjectThe Invite, without itstoken.
Errors
| Status | Code | When and what to do |
|---|---|---|
| 404 | not_found | The link is not valid. The web app shows the link as invalid. Ask the inviter for a new link. |
| 422 | unprocessable | The link has expired or was cancelled. Ask the inviter for a new link. |
| 429 | too_many_requests | More than 20 link previews or link requests in a minute for this account. Wait a minute before opening another link. |
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.getInvitePreview(token) src/lib/proxima/endpoints/launch/shares.ts
Request to join through a link
/launch/invites/link/{token}/request Files a join request through an invite link, or reports that the caller is already a member.
- 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_sentagain.
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
-
tokenstring RequiredLink token from the invite URL.Example4p3xl8eq9ao5swi5wb
Returns 200 OK · application/json
-
okbooleanAlwaystrue. -
statusenumOutcome of the click.Possible valuesrequest_sentalready_member -
launch_ext_idintegerOnly foralready_member: the launch to open. -
chainstringOnly foralready_member: chain ID of the launch.
Errors
| Status | Code | When 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 | The link is not valid. Ask the inviter for a new link. |
| 422 | unprocessable | The link has expired or was cancelled. Ask the inviter for a new link. |
| 429 | too_many_requests | More than 20 link previews or link requests in a minute for this account. Wait a minute before opening another link. |
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.requestLink(token) src/lib/proxima/endpoints/launch/shares.ts
List incoming invites
/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.
-
okbooleanAlwaystrue. -
invitesarray<object>Invite objects.
Errors
| Status | Code | When 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
/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_idstring RequiredID of the direct invite.Exampled71fa141-da50-4ffd-819e-a228f21db19c
Returns 200 OK · application/json
-
okbooleanAlwaystrue. -
grant_idstringID of the grant created. -
launch_ext_idintegerThe launchext_id. -
chainstringChain ID of the launch.
Errors
| Status | Code | When 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
/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_idstring RequiredID of the direct invite.Exampled71fa141-da50-4ffd-819e-a228f21db19c
Returns 200 OK · application/json
-
okbooleanAlwaystrue. -
declinedbooleanWhether the invite changed state.
Errors
| Status | Code | When 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
/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-Matchmakes 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_idstring RequiredThe launchext_id.Example101920010239643 -
grant_idstring RequiredGrant ID (UUID).Examplea037996a-b1ed-4133-b495-3ba07c7249ad
Headers
-
If-Matchinteger RequiredThe grantversionthe edit is based on.Example3
Body parameters application/json
-
operationsarray<string> | string RequiredPermission identifiers, or the stringall. -
export_keysarray<object> OptionalWallet references whose key may be exported. -
use_walletsarray<object> OptionalWallet references the grantee may act on. -
allow_future_walletsboolean OptionalAlso cover wallets added later. -
shared_spend_walletsarray<object> OptionalWallet references that serve outside this launch and may be spent from. -
constraintsobject OptionalLimits on the grant.Child attributes 2
-
withdraw_destinationsarray<object> OptionalAllowed withdraw destinations, each{ chain, address }. -
max_new_walletsinteger | null OptionalCap on wallets the grantee may add.
-
-
expires_atstring | null OptionalISO 8601 expiry, ornullfor none. A past date is refused.
Returns 200 OK · application/json
Returns the updated Grant object.
-
okbooleanAlwaystrue. -
grantobjectThe updated Grant, with its newversion. -
descendants_clampedintegerNumber of descendant grants reduced to fit. -
notestringReminder that jobs already running keep the wallets they captured.
Errors
| Status | Code | When 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
/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_idstring RequiredThe launchext_id.Example101920010239643 -
grant_idstring RequiredGrant ID (UUID).Examplea037996a-b1ed-4133-b495-3ba07c7249ad
Returns 200 OK · application/json
-
okbooleanAlwaystrue. -
revokedintegerNumber of grants revoked, including descendants. -
notestringReminder that running jobs are not stopped.
Errors
| Status | Code | When 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
/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_idstring RequiredThe launchext_id.Example101920010239643 -
grant_idstring RequiredGrant ID (UUID).Examplea037996a-b1ed-4133-b495-3ba07c7249ad
Returns 200 OK · application/json
-
okbooleanAlwaystrue. -
jobsarray<object>Jobs started under the grant, newest first within each kind.Child attributes 4
-
kindstringJob kind:autosell,autobuy,volume,cleanuporwithdraw;market_makeron Solana,sniper_guardon EVM chains. -
idstringJob ID (UUID). Use it on the job's own route to read or stop it. -
statusstringJob status, as stored for its kind, e.g.running. -
created_atstringCreation time. ISO 8601: without a time zone (UTC) for sessions, with one for withdrawals.
-
-
tracearray<object>Recorded actions taken under the grant. -
notestringReminder that revoking the grant does not stop a job.
Errors
| Status | Code | When 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
Check ownership transfer
/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_idstring RequiredThe launchext_id.Example101920010239643
Returns 200 OK · application/json
-
okbooleanAlwaystrue. -
may_transferbooleanWhether ownership can change now. -
reasonstring | nullWhy a transfer is blocked, ornull.
Errors
| Status | Code | When 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