API ReferenceWorker Protocol
Transfer session to another worker
Transfer session to another worker - Rensei REST API operation reference.
Authorization
workerJwt AuthorizationBearer <token>
Runtime JWT minted by the platform at worker registration. Three-segment dotted string. Claims include {jti, proj, org, sub (=workerId), reg, scope[]}. Use on all post-registration worker endpoints.
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
curl -X POST "https://example.com/api/sessions/string/transfer-ownership" \ -H "Content-Type: application/json" \ -d '{ "newWorkerId": "string", "oldWorkerId": "string" }'{
"transferred": true,
"session": {
"linearSessionId": "string",
"trackerSessionId": "string",
"issueId": "string",
"issueIdentifier": "string",
"providerSessionId": "string",
"worktreePath": "string",
"status": "pending",
"createdAt": 0,
"updatedAt": 0,
"workerId": "string",
"queuedAt": 0,
"claimedAt": 0,
"priority": 0,
"promptContext": "string",
"organizationId": "string",
"workType": "research",
"agentId": "string",
"projectName": "string",
"provider": "string",
"totalCostUsd": 0,
"inputTokens": 0,
"outputTokens": 0,
"lastToolName": "string",
"lastToolCalledAt": 0,
"toolCallCount": 0
},
"reason": "string"
}{
"error": "Session not found"
}{
"error": "Session not found"
}