Rensei docs
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
/api/sessions/{id}/external-urls

Authorization

AuthorizationBearer <token>

Short-lived worker runtime JWT minted by the platform. Claims bind the worker, project, organization, registration, and scopes.

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/sessions/string/external-urls" \  -H "Content-Type: application/json" \  -d '{    "externalUrls": [      {        "label": "string",        "url": "http://example.com"      }    ]  }'
{
  "updated": true,
  "externalUrls": [
    {
      "label": "string",
      "url": "string"
    }
  ],
  "reason": "string"
}
{
  "error": "Session not found"
}
{
  "error": "Session not found"
}
{
  "error": "Session not found"
}
{
  "error": "Session not found"
}