Agents

Read File Root

get

Path parameters

agent_idstringRequired

Responses

200

Successful Response

application/json

anyOptional

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

get/api/v2/agents/{agent_id}/files/root

GET /api/v2/agents/{agent_id}/files/root HTTP/1.1
Accept: */*

No content

Read File

get

Path parameters

uidintegerRequired

agent_idstringRequired

Responses

200

Successful Response

application/json

idintegerRequired

session_idstringRequired

namestringRequired

pathstringRequired

is_filebooleanRequired

parent_idinteger · nullableOptional

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

get/api/v2/agents/{agent_id}/files/{uid}

GET /api/v2/agents/{agent_id}/files/{uid} HTTP/1.1
Accept: */*

{
  "id": 1,
  "session_id": "text",
  "name": "text",
  "path": "text",
  "is_file": true,
  "parent_id": 1,
  "downloads": [
    {
      "id": 1,
      "filename": "text",
      "link": "text"
    }
  ],
  "children": [
    {
      "id": 1,
      "session_id": "text",
      "name": "text",
      "path": "text",
      "is_file": true,
      "parent_id": 1,
      "downloads": [
        {
          "id": 1,
          "filename": "text",
          "link": "text"
        }
      ],
      "children": [
        {
          "id": 1,
          "session_id": "text",
          "name": "text",
          "path": "text",
          "is_file": true,
          "parent_id": 1,
          "downloads": [
            {
              "id": 1,
              "filename": "text",
              "link": "text"
            }
          ],
          "children": [
            "[Circular Reference]"
          ]
        }
      ]
    }
  ]
}

Add Tag

post

Path parameters

uidintegerRequired

agent_idstringRequired

Body

namestringRequiredPattern: ^[^:]+$

valuestringRequiredPattern: ^[^:]+$

colorstring · nullableOptional

Responses

201

Successful Response

application/json

anyOptional

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post/api/v2/agents/{agent_id}/tasks/{uid}/tags

POST /api/v2/agents/{agent_id}/tasks/{uid}/tags HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "name": "text",
  "value": "text",
  "color": "text"
}

No content

Update Tag

put

Path parameters

uidintegerRequired

agent_idstringRequired

tag_idintegerRequired

Body

namestringRequiredPattern: ^[^:]+$

valuestringRequiredPattern: ^[^:]+$

colorstring · nullableOptional

Responses

200

Successful Response

application/json

anyOptional

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

put/api/v2/agents/{agent_id}/tasks/{uid}/tags/{tag_id}

PUT /api/v2/agents/{agent_id}/tasks/{uid}/tags/{tag_id} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "name": "text",
  "value": "text",
  "color": "text"
}

No content

Delete Tag

delete

Path parameters

uidintegerRequired

tag_idintegerRequired

agent_idstringRequired

Responses

204

Successful Response

No content

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

delete/api/v2/agents/{agent_id}/tasks/{uid}/tags/{tag_id}

DELETE /api/v2/agents/{agent_id}/tasks/{uid}/tags/{tag_id} HTTP/1.1
Accept: */*

No content

Read Tasks All Agents

get

Query parameters

limitintegerOptionalDefault: -1

pageintegerOptionalDefault: 1

include_full_inputbooleanOptionalDefault: false

include_original_outputbooleanOptionalDefault: false

include_outputbooleanOptionalDefault: true

sincestring · date-time · nullableOptional

order_bystring · enumOptionalDefault: idPossible values:

order_directionstring · enumOptionalDefault: descPossible values:

statusstring · enum · nullableOptionalPossible values:

agentsstring[] · nullableOptional

usersinteger[] · nullableOptional

tagsstring[] · nullableOptional

querystring · nullableOptional

Responses

200

Successful Response

application/json

limitintegerRequired

pageintegerRequired

total_pagesintegerRequired

totalintegerRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

get/api/v2/agents/tasks

GET /api/v2/agents/tasks HTTP/1.1
Accept: */*

{
  "records": [
    {
      "id": 1,
      "input": "text",
      "full_input": "text",
      "output": "text",
      "original_output": "text",
      "user_id": 1,
      "username": "text",
      "agent_id": "text",
      "downloads": [
        {
          "id": 1,
          "filename": "text",
          "link": "text"
        }
      ],
      "module_name": "text",
      "module_options": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "task_name": "text",
      "status": "queued",
      "created_at": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-01-01T00:00:00.000Z",
      "tags": [
        {
          "id": 1,
          "name": "text",
          "value": "text",
          "label": "text",
          "color": "text"
        }
      ]
    }
  ],
  "limit": 1,
  "page": 1,
  "total_pages": 1,
  "total": 1
}

Read Tasks

get

Path parameters

agent_idstringRequired

Query parameters

limitintegerOptionalDefault: -1

pageintegerOptionalDefault: 1

include_full_inputbooleanOptionalDefault: false

include_original_outputbooleanOptionalDefault: false

include_outputbooleanOptionalDefault: true

sincestring · date-time · nullableOptional

order_bystring · enumOptionalDefault: idPossible values:

order_directionstring · enumOptionalDefault: descPossible values:

statusstring · enum · nullableOptionalPossible values:

usersinteger[] · nullableOptional

tagsstring[] · nullableOptional

querystring · nullableOptional

Responses

200

Successful Response

application/json

limitintegerRequired

pageintegerRequired

total_pagesintegerRequired

totalintegerRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

get/api/v2/agents/{agent_id}/tasks

GET /api/v2/agents/{agent_id}/tasks HTTP/1.1
Accept: */*

{
  "records": [
    {
      "id": 1,
      "input": "text",
      "full_input": "text",
      "output": "text",
      "original_output": "text",
      "user_id": 1,
      "username": "text",
      "agent_id": "text",
      "downloads": [
        {
          "id": 1,
          "filename": "text",
          "link": "text"
        }
      ],
      "module_name": "text",
      "module_options": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "task_name": "text",
      "status": "queued",
      "created_at": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-01-01T00:00:00.000Z",
      "tags": [
        {
          "id": 1,
          "name": "text",
          "value": "text",
          "label": "text",
          "color": "text"
        }
      ]
    }
  ],
  "limit": 1,
  "page": 1,
  "total_pages": 1,
  "total": 1
}

Read Task

get

Path parameters

uidintegerRequired

agent_idstringRequired

Responses

200

Successful Response

application/json

idintegerRequired

inputstringRequired

full_inputstring · nullableOptional

outputstring · nullableOptional

original_outputstring · nullableOptional

user_idinteger · nullableOptional

usernamestring · nullableOptional

agent_idstringRequired

module_namestring · nullableOptional

task_namestring · nullableOptional

statusstring · enumRequiredPossible values:

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

get/api/v2/agents/{agent_id}/tasks/{uid}

GET /api/v2/agents/{agent_id}/tasks/{uid} HTTP/1.1
Accept: */*

{
  "id": 1,
  "input": "text",
  "full_input": "text",
  "output": "text",
  "original_output": "text",
  "user_id": 1,
  "username": "text",
  "agent_id": "text",
  "downloads": [
    {
      "id": 1,
      "filename": "text",
      "link": "text"
    }
  ],
  "module_name": "text",
  "module_options": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "task_name": "text",
  "status": "queued",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}

Delete Task

delete

Path parameters

uidintegerRequired

agent_idstringRequired

Responses

204

Successful Response

No content

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

delete/api/v2/agents/{agent_id}/tasks/{uid}

DELETE /api/v2/agents/{agent_id}/tasks/{uid} HTTP/1.1
Accept: */*

No content

Create Task Jobs

post

Path parameters

agent_idstringRequired

Responses

200

Successful Response

application/json

idintegerRequired

inputstringRequired

full_inputstring · nullableOptional

outputstring · nullableOptional

original_outputstring · nullableOptional

user_idinteger · nullableOptional

usernamestring · nullableOptional

agent_idstringRequired

module_namestring · nullableOptional

task_namestring · nullableOptional

statusstring · enumRequiredPossible values:

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post/api/v2/agents/{agent_id}/tasks/jobs

POST /api/v2/agents/{agent_id}/tasks/jobs HTTP/1.1
Accept: */*

{
  "id": 1,
  "input": "text",
  "full_input": "text",
  "output": "text",
  "original_output": "text",
  "user_id": 1,
  "username": "text",
  "agent_id": "text",
  "downloads": [
    {
      "id": 1,
      "filename": "text",
      "link": "text"
    }
  ],
  "module_name": "text",
  "module_options": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "task_name": "text",
  "status": "queued",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}

Create Task Kill Job

post

Path parameters

agent_idstringRequired

Body

idintegerRequired

Responses

200

Successful Response

application/json

idintegerRequired

inputstringRequired

full_inputstring · nullableOptional

outputstring · nullableOptional

original_outputstring · nullableOptional

user_idinteger · nullableOptional

usernamestring · nullableOptional

agent_idstringRequired

module_namestring · nullableOptional

task_namestring · nullableOptional

statusstring · enumRequiredPossible values:

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post/api/v2/agents/{agent_id}/tasks/kill_job

POST /api/v2/agents/{agent_id}/tasks/kill_job HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 8

{
  "id": 1
}

{
  "id": 1,
  "input": "text",
  "full_input": "text",
  "output": "text",
  "original_output": "text",
  "user_id": 1,
  "username": "text",
  "agent_id": "text",
  "downloads": [
    {
      "id": 1,
      "filename": "text",
      "link": "text"
    }
  ],
  "module_name": "text",
  "module_options": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "task_name": "text",
  "status": "queued",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}

Create Task Stop Job

post

Path parameters

agent_idstringRequired

Body

idintegerRequired

Responses

200

Successful Response

application/json

idintegerRequired

inputstringRequired

full_inputstring · nullableOptional

outputstring · nullableOptional

original_outputstring · nullableOptional

user_idinteger · nullableOptional

usernamestring · nullableOptional

agent_idstringRequired

module_namestring · nullableOptional

task_namestring · nullableOptional

statusstring · enumRequiredPossible values:

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post/api/v2/agents/{agent_id}/tasks/stop_job

POST /api/v2/agents/{agent_id}/tasks/stop_job HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 8

{
  "id": 1
}

{
  "id": 1,
  "input": "text",
  "full_input": "text",
  "output": "text",
  "original_output": "text",
  "user_id": 1,
  "username": "text",
  "agent_id": "text",
  "downloads": [
    {
      "id": 1,
      "filename": "text",
      "link": "text"
    }
  ],
  "module_name": "text",
  "module_options": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "task_name": "text",
  "status": "queued",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}

Create Task Shell

post

Executes a command on the agent. If literal is true, it will ignore the built-in aliases such a whoami or ps and execute the command directly.

Path parameters

agent_idstringRequired

Body

commandstringRequired

literalbooleanOptionalDefault: false

Responses

201

Successful Response

application/json

idintegerRequired

inputstringRequired

full_inputstring · nullableOptional

outputstring · nullableOptional

original_outputstring · nullableOptional

user_idinteger · nullableOptional

usernamestring · nullableOptional

agent_idstringRequired

module_namestring · nullableOptional

task_namestring · nullableOptional

statusstring · enumRequiredPossible values:

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post/api/v2/agents/{agent_id}/tasks/shell

POST /api/v2/agents/{agent_id}/tasks/shell HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 34

{
  "command": "text",
  "literal": false
}

{
  "id": 1,
  "input": "text",
  "full_input": "text",
  "output": "text",
  "original_output": "text",
  "user_id": 1,
  "username": "text",
  "agent_id": "text",
  "downloads": [
    {
      "id": 1,
      "filename": "text",
      "link": "text"
    }
  ],
  "module_name": "text",
  "module_options": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "task_name": "text",
  "status": "queued",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}

Create Task Module

post

Path parameters

agent_idstringRequired

Body

module_idstringRequired

ignore_language_version_checkbooleanOptionalDefault: false

ignore_admin_checkbooleanOptionalDefault: false

modified_inputstring · nullableOptional

Responses

201

Successful Response

application/json

idintegerRequired

inputstringRequired

full_inputstring · nullableOptional

outputstring · nullableOptional

original_outputstring · nullableOptional

user_idinteger · nullableOptional

usernamestring · nullableOptional

agent_idstringRequired

module_namestring · nullableOptional

task_namestring · nullableOptional

statusstring · enumRequiredPossible values:

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post/api/v2/agents/{agent_id}/tasks/module

POST /api/v2/agents/{agent_id}/tasks/module HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 154

{
  "module_id": "text",
  "ignore_language_version_check": false,
  "ignore_admin_check": false,
  "options": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  },
  "modified_input": "text"
}

{
  "id": 1,
  "input": "text",
  "full_input": "text",
  "output": "text",
  "original_output": "text",
  "user_id": 1,
  "username": "text",
  "agent_id": "text",
  "downloads": [
    {
      "id": 1,
      "filename": "text",
      "link": "text"
    }
  ],
  "module_name": "text",
  "module_options": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "task_name": "text",
  "status": "queued",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}

Create Task Upload

post

Path parameters

agent_idstringRequired

Body

path_to_filestringRequired

file_idintegerRequired

Responses

201

Successful Response

application/json

idintegerRequired

inputstringRequired

full_inputstring · nullableOptional

outputstring · nullableOptional

original_outputstring · nullableOptional

user_idinteger · nullableOptional

usernamestring · nullableOptional

agent_idstringRequired

module_namestring · nullableOptional

task_namestring · nullableOptional

statusstring · enumRequiredPossible values:

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post/api/v2/agents/{agent_id}/tasks/upload

POST /api/v2/agents/{agent_id}/tasks/upload HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "path_to_file": "text",
  "file_id": 1
}

{
  "id": 1,
  "input": "text",
  "full_input": "text",
  "output": "text",
  "original_output": "text",
  "user_id": 1,
  "username": "text",
  "agent_id": "text",
  "downloads": [
    {
      "id": 1,
      "filename": "text",
      "link": "text"
    }
  ],
  "module_name": "text",
  "module_options": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "task_name": "text",
  "status": "queued",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}

Create Task Download

post

Path parameters

agent_idstringRequired

Body

path_to_filestringRequired

Responses

201

Successful Response

application/json

idintegerRequired

inputstringRequired

full_inputstring · nullableOptional

outputstring · nullableOptional

original_outputstring · nullableOptional

user_idinteger · nullableOptional

usernamestring · nullableOptional

agent_idstringRequired

module_namestring · nullableOptional

task_namestring · nullableOptional

statusstring · enumRequiredPossible values:

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post/api/v2/agents/{agent_id}/tasks/download

POST /api/v2/agents/{agent_id}/tasks/download HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 23

{
  "path_to_file": "text"
}

{
  "id": 1,
  "input": "text",
  "full_input": "text",
  "output": "text",
  "original_output": "text",
  "user_id": 1,
  "username": "text",
  "agent_id": "text",
  "downloads": [
    {
      "id": 1,
      "filename": "text",
      "link": "text"
    }
  ],
  "module_name": "text",
  "module_options": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "task_name": "text",
  "status": "queued",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}

Create Task Sysinfo

post

Path parameters

agent_idstringRequired

Body

object · SysinfoPostRequestOptional

Responses

201

Successful Response

application/json

idintegerRequired

inputstringRequired

full_inputstring · nullableOptional

outputstring · nullableOptional

original_outputstring · nullableOptional

user_idinteger · nullableOptional

usernamestring · nullableOptional

agent_idstringRequired

module_namestring · nullableOptional

task_namestring · nullableOptional

statusstring · enumRequiredPossible values:

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post/api/v2/agents/{agent_id}/tasks/sysinfo

POST /api/v2/agents/{agent_id}/tasks/sysinfo HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

{
  "id": 1,
  "input": "text",
  "full_input": "text",
  "output": "text",
  "original_output": "text",
  "user_id": 1,
  "username": "text",
  "agent_id": "text",
  "downloads": [
    {
      "id": 1,
      "filename": "text",
      "link": "text"
    }
  ],
  "module_name": "text",
  "module_options": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "task_name": "text",
  "status": "queued",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}

Create Task Update Comms

post

Path parameters

agent_idstringRequired

Body

new_listener_idintegerRequired

Responses

201

Successful Response

application/json

idintegerRequired

inputstringRequired

full_inputstring · nullableOptional

outputstring · nullableOptional

original_outputstring · nullableOptional

user_idinteger · nullableOptional

usernamestring · nullableOptional

agent_idstringRequired

module_namestring · nullableOptional

task_namestring · nullableOptional

statusstring · enumRequiredPossible values:

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post/api/v2/agents/{agent_id}/tasks/update_comms

POST /api/v2/agents/{agent_id}/tasks/update_comms HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 21

{
  "new_listener_id": 1
}

{
  "id": 1,
  "input": "text",
  "full_input": "text",
  "output": "text",
  "original_output": "text",
  "user_id": 1,
  "username": "text",
  "agent_id": "text",
  "downloads": [
    {
      "id": 1,
      "filename": "text",
      "link": "text"
    }
  ],
  "module_name": "text",
  "module_options": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "task_name": "text",
  "status": "queued",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}

Create Task Update Sleep

post

Path parameters

agent_idstringRequired

Body

delayintegerRequired

jitternumber · max: 1Required

Responses

201

Successful Response

application/json

idintegerRequired

inputstringRequired

full_inputstring · nullableOptional

outputstring · nullableOptional

original_outputstring · nullableOptional

user_idinteger · nullableOptional

usernamestring · nullableOptional

agent_idstringRequired

module_namestring · nullableOptional

task_namestring · nullableOptional

statusstring · enumRequiredPossible values:

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post/api/v2/agents/{agent_id}/tasks/sleep

POST /api/v2/agents/{agent_id}/tasks/sleep HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 22

{
  "delay": 1,
  "jitter": 1
}

{
  "id": 1,
  "input": "text",
  "full_input": "text",
  "output": "text",
  "original_output": "text",
  "user_id": 1,
  "username": "text",
  "agent_id": "text",
  "downloads": [
    {
      "id": 1,
      "filename": "text",
      "link": "text"
    }
  ],
  "module_name": "text",
  "module_options": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "task_name": "text",
  "status": "queued",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}

Create Task Update Kill Date

post

Path parameters

agent_idstringRequired

Body

kill_datestringRequired

Responses

201

Successful Response

application/json

idintegerRequired

inputstringRequired

full_inputstring · nullableOptional

outputstring · nullableOptional

original_outputstring · nullableOptional

user_idinteger · nullableOptional

usernamestring · nullableOptional

agent_idstringRequired

module_namestring · nullableOptional

task_namestring · nullableOptional

statusstring · enumRequiredPossible values:

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post/api/v2/agents/{agent_id}/tasks/kill_date

POST /api/v2/agents/{agent_id}/tasks/kill_date HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 20

{
  "kill_date": "text"
}

{
  "id": 1,
  "input": "text",
  "full_input": "text",
  "output": "text",
  "original_output": "text",
  "user_id": 1,
  "username": "text",
  "agent_id": "text",
  "downloads": [
    {
      "id": 1,
      "filename": "text",
      "link": "text"
    }
  ],
  "module_name": "text",
  "module_options": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "task_name": "text",
  "status": "queued",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}

Create Task Update Working Hours

post

Path parameters

agent_idstringRequired

Body

working_hoursstringRequired

Responses

201

Successful Response

application/json

idintegerRequired

inputstringRequired

full_inputstring · nullableOptional

outputstring · nullableOptional

original_outputstring · nullableOptional

user_idinteger · nullableOptional

usernamestring · nullableOptional

agent_idstringRequired

module_namestring · nullableOptional

task_namestring · nullableOptional

statusstring · enumRequiredPossible values:

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post/api/v2/agents/{agent_id}/tasks/working_hours

POST /api/v2/agents/{agent_id}/tasks/working_hours HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "working_hours": "text"
}

{
  "id": 1,
  "input": "text",
  "full_input": "text",
  "output": "text",
  "original_output": "text",
  "user_id": 1,
  "username": "text",
  "agent_id": "text",
  "downloads": [
    {
      "id": 1,
      "filename": "text",
      "link": "text"
    }
  ],
  "module_name": "text",
  "module_options": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "task_name": "text",
  "status": "queued",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}

Create Task Update Directory List

post

Path parameters

agent_idstringRequired

Body

pathstringRequired

Responses

201

Successful Response

application/json

idintegerRequired

inputstringRequired

full_inputstring · nullableOptional

outputstring · nullableOptional

original_outputstring · nullableOptional

user_idinteger · nullableOptional

usernamestring · nullableOptional

agent_idstringRequired

module_namestring · nullableOptional

task_namestring · nullableOptional

statusstring · enumRequiredPossible values:

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post/api/v2/agents/{agent_id}/tasks/directory_list

POST /api/v2/agents/{agent_id}/tasks/directory_list HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "path": "text"
}

{
  "id": 1,
  "input": "text",
  "full_input": "text",
  "output": "text",
  "original_output": "text",
  "user_id": 1,
  "username": "text",
  "agent_id": "text",
  "downloads": [
    {
      "id": 1,
      "filename": "text",
      "link": "text"
    }
  ],
  "module_name": "text",
  "module_options": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "task_name": "text",
  "status": "queued",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}

Create Task Exit

post

Path parameters

agent_idstringRequired

Body

object · ExitPostRequestOptional

Responses

201

Successful Response

application/json

idintegerRequired

inputstringRequired

full_inputstring · nullableOptional

outputstring · nullableOptional

original_outputstring · nullableOptional

user_idinteger · nullableOptional

usernamestring · nullableOptional

agent_idstringRequired

module_namestring · nullableOptional

task_namestring · nullableOptional

statusstring · enumRequiredPossible values:

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post/api/v2/agents/{agent_id}/tasks/exit

POST /api/v2/agents/{agent_id}/tasks/exit HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

{
  "id": 1,
  "input": "text",
  "full_input": "text",
  "output": "text",
  "original_output": "text",
  "user_id": 1,
  "username": "text",
  "agent_id": "text",
  "downloads": [
    {
      "id": 1,
      "filename": "text",
      "link": "text"
    }
  ],
  "module_name": "text",
  "module_options": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "task_name": "text",
  "status": "queued",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}

Create Task Socks

post

Path parameters

agent_idstringRequired

Body

portintegerRequired

Responses

201

Successful Response

application/json

idintegerRequired

inputstringRequired

full_inputstring · nullableOptional

outputstring · nullableOptional

original_outputstring · nullableOptional

user_idinteger · nullableOptional

usernamestring · nullableOptional

agent_idstringRequired

module_namestring · nullableOptional

task_namestring · nullableOptional

statusstring · enumRequiredPossible values:

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post/api/v2/agents/{agent_id}/tasks/socks

POST /api/v2/agents/{agent_id}/tasks/socks HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 10

{
  "port": 1
}

{
  "id": 1,
  "input": "text",
  "full_input": "text",
  "output": "text",
  "original_output": "text",
  "user_id": 1,
  "username": "text",
  "agent_id": "text",
  "downloads": [
    {
      "id": 1,
      "filename": "text",
      "link": "text"
    }
  ],
  "module_name": "text",
  "module_options": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "task_name": "text",
  "status": "queued",
  "created_at": "2026-01-01T00:00:00.000Z",
  "updated_at": "2026-01-01T00:00:00.000Z",
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}

Add Tag

post

Path parameters

uidstringRequired

Body

namestringRequiredPattern: ^[^:]+$

valuestringRequiredPattern: ^[^:]+$

colorstring · nullableOptional

Responses

201

Successful Response

application/json

anyOptional

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

post/api/v2/agents/{uid}/tags

POST /api/v2/agents/{uid}/tags HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "name": "text",
  "value": "text",
  "color": "text"
}

No content

Update Tag

put

Path parameters

uidstringRequired

tag_idintegerRequired

Body

namestringRequiredPattern: ^[^:]+$

valuestringRequiredPattern: ^[^:]+$

colorstring · nullableOptional

Responses

200

Successful Response

application/json

anyOptional

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

put/api/v2/agents/{uid}/tags/{tag_id}

PUT /api/v2/agents/{uid}/tags/{tag_id} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "name": "text",
  "value": "text",
  "color": "text"
}

No content

Delete Tag

delete

Path parameters

uidstringRequired

tag_idintegerRequired

Responses

204

Successful Response

No content

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

delete/api/v2/agents/{uid}/tags/{tag_id}

DELETE /api/v2/agents/{uid}/tags/{tag_id} HTTP/1.1
Accept: */*

No content

Read Agent Checkins All

get

Query parameters

agentsstring[]Optional

limitintegerOptionalDefault: 1000

pageintegerOptionalDefault: 1

start_datestring · date-time · nullableOptional

end_datestring · date-time · nullableOptional

order_directionstring · enumOptionalDefault: descPossible values:

Responses

200

Successful Response

application/json

limitintegerRequired

pageintegerRequired

total_pagesintegerRequired

totalintegerRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

get/api/v2/agents/checkins

GET /api/v2/agents/checkins HTTP/1.1
Accept: */*

{
  "records": [
    {
      "agent_id": "text",
      "checkin_time": "2026-01-01T00:00:00.000Z"
    }
  ],
  "limit": 1,
  "page": 1,
  "total_pages": 1,
  "total": 1
}

Read Agent Checkins Aggregate

get

Query parameters

agentsstring[]Optional

start_datestring · date-time · nullableOptional

end_datestring · date-time · nullableOptional

bucket_sizestring · enum · nullableOptionalDefault: dayPossible values:

Responses

200

Successful Response

application/json

start_datestring · date-time · nullableOptional

end_datestring · date-time · nullableOptional

bucket_sizestringRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

get/api/v2/agents/checkins/aggregate

GET /api/v2/agents/checkins/aggregate HTTP/1.1
Accept: */*

{
  "records": [
    {
      "count": 1,
      "checkin_time": "2026-01-01T00:00:00.000Z"
    }
  ],
  "start_date": "2026-01-01T00:00:00.000Z",
  "end_date": "2026-01-01T00:00:00.000Z",
  "bucket_size": "text"
}

Read Agent

get

Path parameters

uidstringRequired

Responses

200

Successful Response

application/json

session_idstringRequired

namestringRequired

listenerstringRequired

host_idinteger · nullableOptional

hostnamestring · nullableOptional

languagestring · nullableOptional

language_versionstring · nullableOptional

delayintegerRequired

jitternumberRequired

external_ipstring · nullableOptional

internal_ipstring · nullableOptional

usernamestring · nullableOptional

high_integrityboolean · nullableOptional

process_idinteger · nullableOptional

process_namestring · nullableOptional

os_detailsstring · nullableOptional

noncestringRequired

checkin_timestring · date-timeRequired

lastseen_timestring · date-timeRequired

parentstring · nullableOptional

childrenstring · nullableOptional

serversstring · nullableOptional

profilestring · nullableOptional

functionsstring · nullableOptional

kill_datestring · nullableOptional

working_hoursstring · nullableOptional

lost_limitintegerRequired

notesstring · nullableOptional

architecturestring · nullableOptional

archivedbooleanRequired

stalebooleanRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

get/api/v2/agents/{uid}

GET /api/v2/agents/{uid} HTTP/1.1
Accept: */*

{
  "session_id": "text",
  "name": "text",
  "listener": "text",
  "host_id": 1,
  "hostname": "text",
  "language": "text",
  "language_version": "text",
  "delay": 1,
  "jitter": 1,
  "external_ip": "text",
  "internal_ip": "text",
  "username": "text",
  "high_integrity": true,
  "process_id": 1,
  "process_name": "text",
  "os_details": "text",
  "nonce": "text",
  "checkin_time": "2026-01-01T00:00:00.000Z",
  "lastseen_time": "2026-01-01T00:00:00.000Z",
  "parent": "text",
  "children": "text",
  "servers": "text",
  "profile": "text",
  "functions": "text",
  "kill_date": "text",
  "working_hours": "text",
  "lost_limit": 1,
  "notes": "text",
  "architecture": "text",
  "archived": true,
  "stale": true,
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}

Update Agent

put

Path parameters

uidstringRequired

Body

namestringRequired

notesstring · nullableOptional

Responses

200

Successful Response

application/json

session_idstringRequired

namestringRequired

listenerstringRequired

host_idinteger · nullableOptional

hostnamestring · nullableOptional

languagestring · nullableOptional

language_versionstring · nullableOptional

delayintegerRequired

jitternumberRequired

external_ipstring · nullableOptional

internal_ipstring · nullableOptional

usernamestring · nullableOptional

high_integrityboolean · nullableOptional

process_idinteger · nullableOptional

process_namestring · nullableOptional

os_detailsstring · nullableOptional

noncestringRequired

checkin_timestring · date-timeRequired

lastseen_timestring · date-timeRequired

parentstring · nullableOptional

childrenstring · nullableOptional

serversstring · nullableOptional

profilestring · nullableOptional

functionsstring · nullableOptional

kill_datestring · nullableOptional

working_hoursstring · nullableOptional

lost_limitintegerRequired

notesstring · nullableOptional

architecturestring · nullableOptional

archivedbooleanRequired

stalebooleanRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

put/api/v2/agents/{uid}

PUT /api/v2/agents/{uid} HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 30

{
  "name": "text",
  "notes": "text"
}

{
  "session_id": "text",
  "name": "text",
  "listener": "text",
  "host_id": 1,
  "hostname": "text",
  "language": "text",
  "language_version": "text",
  "delay": 1,
  "jitter": 1,
  "external_ip": "text",
  "internal_ip": "text",
  "username": "text",
  "high_integrity": true,
  "process_id": 1,
  "process_name": "text",
  "os_details": "text",
  "nonce": "text",
  "checkin_time": "2026-01-01T00:00:00.000Z",
  "lastseen_time": "2026-01-01T00:00:00.000Z",
  "parent": "text",
  "children": "text",
  "servers": "text",
  "profile": "text",
  "functions": "text",
  "kill_date": "text",
  "working_hours": "text",
  "lost_limit": 1,
  "notes": "text",
  "architecture": "text",
  "archived": true,
  "stale": true,
  "tags": [
    {
      "id": 1,
      "name": "text",
      "value": "text",
      "label": "text",
      "color": "text"
    }
  ]
}

Read Agents

get

Query parameters

include_archivedbooleanOptionalDefault: false

include_stalebooleanOptionalDefault: true

Responses

200

Successful Response

application/json

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

get/api/v2/agents

GET /api/v2/agents HTTP/1.1
Accept: */*

{
  "records": [
    {
      "session_id": "text",
      "name": "text",
      "listener": "text",
      "host_id": 1,
      "hostname": "text",
      "language": "text",
      "language_version": "text",
      "delay": 1,
      "jitter": 1,
      "external_ip": "text",
      "internal_ip": "text",
      "username": "text",
      "high_integrity": true,
      "process_id": 1,
      "process_name": "text",
      "os_details": "text",
      "nonce": "text",
      "checkin_time": "2026-01-01T00:00:00.000Z",
      "lastseen_time": "2026-01-01T00:00:00.000Z",
      "parent": "text",
      "children": "text",
      "servers": "text",
      "profile": "text",
      "functions": "text",
      "kill_date": "text",
      "working_hours": "text",
      "lost_limit": 1,
      "notes": "text",
      "architecture": "text",
      "archived": true,
      "stale": true,
      "tags": [
        {
          "id": 1,
          "name": "text",
          "value": "text",
          "label": "text",
          "color": "text"
        }
      ]
    }
  ]
}

Read Agent Checkins

get

Path parameters

uidstringRequired

Query parameters

limitintegerOptionalDefault: -1

pageintegerOptionalDefault: 1

start_datestring · date-time · nullableOptional

end_datestring · date-time · nullableOptional

order_directionstring · enumOptionalDefault: descPossible values:

Responses

200

Successful Response

application/json

limitintegerRequired

pageintegerRequired

total_pagesintegerRequired

totalintegerRequired

400

Bad request

application/json

404

Not found

application/json

422

Validation Error

application/json

get/api/v2/agents/{uid}/checkins

GET /api/v2/agents/{uid}/checkins HTTP/1.1
Accept: */*

{
  "records": [
    {
      "agent_id": "text",
      "checkin_time": "2026-01-01T00:00:00.000Z"
    }
  ],
  "limit": 1,
  "page": 1,
  "total_pages": 1,
  "total": 1
}