---
title: "Create a new sighting"
method: POST
path: "/sighting"
tags: ["sighting"]
---

# Create a new sighting

`POST /sighting`

Create a new sighting.

## Headers

- `X-Fields` string, mask

## Request body

- Sighting
  - `uuid` string — Sighting UUID.
  - `vulnerability_lookup_origin` string — UUID of the Vulnerability-Lookup origin instance.
  - `creation_timestamp` string, date-time — Creation time of the sighting.
  - `type` string — Type of the sighting.
  - `source` string — The source of the sighting (Fediverse status URI, link, tool, etc.).
  - `content` string — Optional content of the sighting (e.g. the body of a Telegram message, a Bluesky/Mastodon post, a GitHub Gist or a blog article).
  - `vulnerability` string — Vulnerability id.
  - `author` User
    - `login` string — Login of the user.

## Response `201`

Success.

- SightingsList[]
  - `metadata` Metadata
    - `count` integer — Total number of the items of the data.
    - `page` integer — Number of the page.
    - `per_page` integer — Requested limit data.
  - `data` Sighting[] — List of sightings.
    - `uuid` string — Sighting UUID.
    - `vulnerability_lookup_origin` string — UUID of the Vulnerability-Lookup origin instance.
    - `creation_timestamp` string, date-time — Creation time of the sighting.
    - `type` string — Type of the sighting.
    - `source` string — The source of the sighting (Fediverse status URI, link, tool, etc.).
    - `content` string — Optional content of the sighting (e.g. the body of a Telegram message, a Bluesky/Mastodon post, a GitHub Gist or a blog article).
    - `vulnerability` string — Vulnerability id.
    - `author` User
      - `login` string — Login of the user.

## Other responses

- `400` — Incorrect payload to instantiate a sighting.
- `409` — Duplicate sighting.

---

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