Sessions

Share a link with the agent

Registers an https URL with the session. The agent sees only the returned reference and can open it once in the session's cloud browser by passing the reference to browser_use open_tab; the URL itself is stored encrypted and never returned. Mention the reference in a message to ask the agent to open it.

<sub>Scope: run</sub>

post/v3/organizations/{orgId}/sessions/{sessionId}/shared-links

Request

  • Base URL: https://api.reasonmachines.com
  • URL: https://api.reasonmachines.com/v3/organizations/{orgId}/sessions/{sessionId}/shared-links
  • Auth: HTTP bearer

Request body

urlstring required

Absolute https URL to open in the session's cloud browser. Stored encrypted; never returned or shown to the agent.

labelstring

Short display name, at most 80 characters. Defaults to the URL's host.

expires_in_secondsinteger

Lifetime from 60 to 86400 seconds.

Response

The shared link.

idstring required
referencestring required

The only form the agent sees: pass it to browser_use open_tab as the url.

labelstring required
originstring required

Scheme and host of the stored URL.

status'active' | 'opened' | 'revoked' | 'expired' required
created_by_user_idstring nullable required
created_atstring required
expires_atstring required
opened_atstring nullable required
revoked_atstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.