---
title: "POST /submit"
method: POST
path: "/submit"
---

# POST /submit

`POST /submit`

## Request body

- ScanResult
  - `scan_id` string, required — The scan id given to the agent identify this scan
  - `ip` string, required — The ip address that was scanned
  - `tags` string[] — The tags that apply the scanned ip address
  - `scan_reason` 'automatic' | 'manual' | 'requested', required — The reason for performing this scan.
  - `xml_data` string, required — The .xml output from nmap
  - `nmap_data` string, required — The .nmap output from nmap
  - `gnmap_data` string, required — The .gnmap output from nmap
  - `scan_start` string, required — Timestamp when the agent started its scan
  - `scan_stop` string, required — Timestamp when the agent stopped its scan
  - `is_up` boolean — Whether the host was determined to be up or down
  - `port_count` integer — Number of ports found if the host is up
  - `timed_out` boolean — True if the nmap process timed out
  - `screenshots` object[] — Array of screenshot objects representing all the screenshots taken against a host
    - `host` string
    - `port` integer
    - `service` string
    - `data` string

## Response `200`

The server was able to parse the response and handled it accordingly.

- GenericResponse
  - `status` integer, required — An HTTP Status code
  - `message` string, required — A human friendly error message
  - `retry` boolean — If true, retry the request, otherwise do not

## Other responses

- `403` — Not authorized. Please provide a valid agent token

---

[API](https://skmtc.net/natlas/apis/natlas-agent-api.md) · [All operations](https://skmtc.net/natlas/apis/natlas-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/natlas/natlas-agent-api/versions/053873ac3f27/schema)