# 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"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dev-docs.tasknet.co/reference/api-reference/operators.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.