> For the complete documentation index, see [llms.txt](https://dev-docs.tasknet.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev-docs.tasknet.co/reference/api-reference/operators.md).

# Operators

## List all operators

> Retrieves a list of all available operators

```json
{"openapi":"3.0.1","info":{"title":"tasknet-api","version":"1.0.0"},"tags":[],"servers":[{"url":"https://api.tasknet.co"}],"security":[{"ApiKey":[],"ApiKeyUUID":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"X-Api-Key"}},"schemas":{"Operator":{"type":"object","required":["numOfBrowsers","info","connectedAt","id"],"properties":{"numOfBrowsers":{"type":"integer","minimum":0},"info":{"$ref":"#/components/schemas/OperatorInfo"},"connectedAt":{"type":"string","format":"date-time"},"id":{"type":"string"}}},"OperatorInfo":{"type":"object","required":["platform","architecture","freeMemory","totalMemory","cpuModel","hostname"],"properties":{"platform":{"type":"string"},"architecture":{"type":"string"},"freeMemory":{"type":"integer"},"totalMemory":{"type":"integer"},"cpuModel":{"type":"string"},"hostname":{"type":"string"}}},"BaseError":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{}}}}},"paths":{"/v1/operators/listAll":{"get":{"tags":["operators"],"summary":"List all operators","description":"Retrieves a list of all available operators","responses":{"200":{"description":"List of all operators","content":{"application/json":{"schema":{"type":"object","required":["nodes"],"properties":{"nodes":{"type":"array","items":{"$ref":"#/components/schemas/Operator"}}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseError"}}}}}}}}}
```

## Get operator information

> Retrieves detailed information about a specific operator

```json
{"openapi":"3.0.1","info":{"title":"tasknet-api","version":"1.0.0"},"tags":[],"servers":[{"url":"https://api.tasknet.co"}],"security":[{"ApiKey":[],"ApiKeyUUID":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"X-Api-Key"}},"schemas":{"Operator":{"type":"object","required":["numOfBrowsers","info","connectedAt","id"],"properties":{"numOfBrowsers":{"type":"integer","minimum":0},"info":{"$ref":"#/components/schemas/OperatorInfo"},"connectedAt":{"type":"string","format":"date-time"},"id":{"type":"string"}}},"OperatorInfo":{"type":"object","required":["platform","architecture","freeMemory","totalMemory","cpuModel","hostname"],"properties":{"platform":{"type":"string"},"architecture":{"type":"string"},"freeMemory":{"type":"integer"},"totalMemory":{"type":"integer"},"cpuModel":{"type":"string"},"hostname":{"type":"string"}}},"BaseError":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{}}}}},"paths":{"/v1/operators/{operatorId}/info":{"get":{"tags":["operators"],"summary":"Get operator information","description":"Retrieves detailed information about a specific operator","parameters":[{"name":"operatorId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Operator information","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operator"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseError"}}}}}}}}}
```

## Get random operator

> Retrieves a random operator ID

```json
{"openapi":"3.0.1","info":{"title":"tasknet-api","version":"1.0.0"},"tags":[],"servers":[{"url":"https://api.tasknet.co"}],"security":[{"ApiKey":[],"ApiKeyUUID":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"X-Api-Key"}},"schemas":{"BaseError":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{}}}}},"paths":{"/v1/operators/random":{"get":{"tags":["operators"],"summary":"Get random operator","description":"Retrieves a random operator ID","responses":{"200":{"description":"Random operator ID","content":{"application/json":{"schema":{"type":"object","required":["operatorId"],"properties":{"operatorId":{"type":"string"}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseError"}}}}}}}}}
```

## Get operators information

> Retrieves information about all operators and total browser count

```json
{"openapi":"3.0.1","info":{"title":"tasknet-api","version":"1.0.0"},"tags":[],"servers":[{"url":"https://api.tasknet.co"}],"security":[{"ApiKey":[],"ApiKeyUUID":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"apiKey","in":"header","name":"X-Api-Key"}},"schemas":{"Operator":{"type":"object","required":["numOfBrowsers","info","connectedAt","id"],"properties":{"numOfBrowsers":{"type":"integer","minimum":0},"info":{"$ref":"#/components/schemas/OperatorInfo"},"connectedAt":{"type":"string","format":"date-time"},"id":{"type":"string"}}},"OperatorInfo":{"type":"object","required":["platform","architecture","freeMemory","totalMemory","cpuModel","hostname"],"properties":{"platform":{"type":"string"},"architecture":{"type":"string"},"freeMemory":{"type":"integer"},"totalMemory":{"type":"integer"},"cpuModel":{"type":"string"},"hostname":{"type":"string"}}},"BaseError":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{}}}}},"paths":{"/v1/operators/info":{"get":{"tags":["operators"],"summary":"Get operators information","description":"Retrieves information about all operators and total browser count","responses":{"200":{"description":"Operators information and browser count","content":{"application/json":{"schema":{"type":"object","required":["nodes","browsers"],"properties":{"nodes":{"type":"array","items":{"$ref":"#/components/schemas/Operator"}},"browsers":{"type":"integer","minimum":0}}}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseError"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseError"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseError"}}}}}}}}}
```