---
title: "Submit a sample"
method: POST
path: "/samples"
---

# Submit a sample

`POST /samples`

Submit a file or URL for sandbox malware analysis via upload, fetch, or import modes.

## Response `200`

Sample accepted for analysis.

- object
  - `id` string — Assigned sample ID
  - `status` 'pending' — Initial status (always 'pending')
  - `kind` 'file' | 'url' — Submission type
  - `filename` string — Original filename (file submissions only)
  - `url` string — Submitted URL (URL submissions only)
  - `private` boolean — Whether the sample is private
  - `submitted` string, date-time — ISO 8601 submission timestamp

## Other responses

- `400` — Bad request (e.g., missing required fields).

---

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