curl --request GET \
--url https://control.ergoly.ai/api/v1/workers/{id}/eworks \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://control.ergoly.ai/api/v1/workers/{id}/eworks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://control.ergoly.ai/api/v1/workers/{id}/eworks"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "3b7e1c44-2d59-4f0a-9c81-5e6d7a8b9c01",
"organizationId": "0d4c9f2e-4b8a-4a5b-9e21-6f9c2a1b7d30",
"workerId": "8f1c2d3e-9a4b-4c5d-8e6f-1a2b3c4d5e6f",
"clientId": "c1a2b3c4-d5e6-4f70-8912-3a4b5c6d7e8f",
"tier": "client",
"status": "active",
"sandboxClass": "container",
"daytonaSandboxId": "sbx_9f21c4a8",
"lettaAgentId": "agent-7c1d0b3e",
"snapshotName": "ework-3f9a1c7d",
"sleepingAt": "2026-03-04T11:02:10.000Z",
"wakingAt": null,
"lastActivityAt": "2026-03-04T10:57:03.000Z",
"lastWakeAt": "2026-03-04T08:41:55.000Z",
"createdAt": "2026-02-11T14:09:40.000Z",
"updatedAt": "2026-03-04T11:02:10.000Z"
}
],
"page": {
"limit": 50,
"hasMore": true,
"nextCursor": "MjAyNi0wMy0wNFQwOToxNDowMi4wMDBafDhmMWMyZDNlLTlhNGItNGM1ZC04ZTZmLTFhMmIzYzRkNWU2Zg"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docs": "<string>"
}
}List a worker's copies
One core ework plus one per bound Client. An empty list means this Worker has no eworks; a 404 means no such Worker for this credential. The two are kept apart deliberately — deriving the first from the second would report another tenant’s Worker as one of yours that happens to be empty.
curl --request GET \
--url https://control.ergoly.ai/api/v1/workers/{id}/eworks \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://control.ergoly.ai/api/v1/workers/{id}/eworks', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://control.ergoly.ai/api/v1/workers/{id}/eworks"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": [
{
"id": "3b7e1c44-2d59-4f0a-9c81-5e6d7a8b9c01",
"organizationId": "0d4c9f2e-4b8a-4a5b-9e21-6f9c2a1b7d30",
"workerId": "8f1c2d3e-9a4b-4c5d-8e6f-1a2b3c4d5e6f",
"clientId": "c1a2b3c4-d5e6-4f70-8912-3a4b5c6d7e8f",
"tier": "client",
"status": "active",
"sandboxClass": "container",
"daytonaSandboxId": "sbx_9f21c4a8",
"lettaAgentId": "agent-7c1d0b3e",
"snapshotName": "ework-3f9a1c7d",
"sleepingAt": "2026-03-04T11:02:10.000Z",
"wakingAt": null,
"lastActivityAt": "2026-03-04T10:57:03.000Z",
"lastWakeAt": "2026-03-04T08:41:55.000Z",
"createdAt": "2026-02-11T14:09:40.000Z",
"updatedAt": "2026-03-04T11:02:10.000Z"
}
],
"page": {
"limit": 50,
"hasMore": true,
"nextCursor": "MjAyNi0wMy0wNFQwOToxNDowMi4wMDBafDhmMWMyZDNlLTlhNGItNGM1ZC04ZTZmLTFhMmIzYzRkNWU2Zg"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docs": "<string>"
}
}{
"error": {
"code": "unauthorized",
"message": "<string>",
"docs": "<string>"
}
}Authorizations
An organization-scoped API key, minted in control under Settings → API keys. Every failure to authenticate answers one identical 401: "Provide a valid organization-scoped API key or an active session." Each operation names the one scope it is filed under, <resource>:<read|write>, where the resource is the first path segment after /api/v1/; a key minted today carries all 22 of them. Scopes are RECORDED — on the key and on every audit row — and are not yet enforced: no request is refused for want of one.
Path Parameters
The Worker id. A malformed id answers 404, exactly as another organization's well-formed id does.
Query Parameters
Narrow to one Client. Rows that belong to no Client — a core-tier ework, a room marked internal, a core-tier task — are excluded, because they are not that Client's. A malformed id is a 400; a well-formed id naming another organization's Client answers an empty list.
Page size. Defaults to 50, clamped at 200. A value that is not a positive integer is a 400.
Opaque keyset cursor from the previous page's page.nextCursor. A cursor this API did not issue is a 400, never a silent page one.

