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.
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"
}