API ReferenceWorker Protocol
Update Linear agent session with external URLs
Posts external URLs (PR links, preview URLs, etc.) to the Linear agent session for display in the Linear UI. Sessions without a `linearSessionId` (governor-generated sessions) return `{ updated: false }` without error. Fail-closed: Linear API errors return 500.
POST
header
AuthorizationBearer <JWT>Short-lived worker runtime JWT minted by the platform. Claims bind the worker, project, organization, registration, and scopes.
id*stringapplication/json- body
externalUrls*array<>workspaceId?stringOptional org ID override; defaults to the session's organizationId.
External URLs updated (or skipped for governor sessions).
application/json- response
updated*booleanexternalUrls?array<>reason?stringPopulated when updated is false.
curl -X POST 'https://app.rensei.ai/api/sessions/string/external-urls' \ -H 'Content-Type: application/json' \ -d '{ "externalUrls": [ { "label": "string", "url": "http://example.com" } ]}'Example Response
{ "updated": true, "externalUrls": [ { "label": "string", "url": "string" } ], "reason": "string"}