---
title: "Add Scenario Screening"
method: POST
path: "/conjunction_messages/{cdm_id}/mitigation_scenarios/{scenario_id}/screening"
tags: ["Mitigation"]
---

# Add Scenario Screening

`POST /conjunction_messages/{cdm_id}/mitigation_scenarios/{scenario_id}/screening`

## Request

- Base URL: `https://api.satcat.com/api/satcat`
- URL: `https://api.satcat.com/api/satcat/conjunction_messages/{cdm_id}/mitigation_scenarios/{scenario_id}/screening`
- Auth: OAuth 2 (client credentials, token URL `oauth/token`; password, token URL `login`)

Post screening associated with a theoretical CDM scenario.<br/>

## Path parameters

- `cdm_id` string, required
- `scenario_id` string, required

## Request body

- ScreeningSubmit
  - `screening_params` ScreeningParams
    - `threshold_radius_km` number
    - `default_secondary_hbr_m` number
    - `propagation_start_time` string, date-time, nullable
    - `propagation_duration_s` number, nullable
    - `propagation_timestep_s` number, nullable
    - `title` string, nullable
    - `notes` string, nullable
  - `screening_secondaries_catalog` string

## Response `201`

Successful Response

- ScreeningRead
  - `id` string, uuid, required
  - `group_id` string, uuid, nullable
  - `owner` UserProfilePreview
    - `id` string, uuid, required
    - `username` string, nullable
    - `full_name` string, nullable
    - `avatar_url` string, nullable
    - `email` string, nullable
  - `status` 'CREATED' | 'PENDING' | 'RUNNING' | 'SUCCESS' | 'FAILURE' | 'CANCELED', required
  - `started_at` string, date-time, nullable
  - `created_at` string, date-time, nullable
  - `completed_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable
  - `threshold_radius_km` number, required
  - `threshold_radius_manned_km` number, nullable
  - `threshold_radius_active_km` number, nullable
  - `threshold_radius_debris_km` number, nullable
  - `default_secondary_hbr_m` number, required
  - `auto_archive` boolean, required
  - `include_primary_vs_primary` boolean, required
  - `title` string, nullable
  - `notes` string, nullable
  - `screening_type` 'ON_ORBIT' | 'LAUNCH', required
  - `engine` 'automatic' | 'classic' | 'caskd', required
  - `engine_used` 'automatic' | 'classic' | 'caskd'
  - `hard_body_shape` 'SQUARE' | 'CIRCLE', required
  - `strict_coverage` boolean, required
  - `publish_cdms` boolean, required
  - `allow_synthetic_covariance` boolean, required
  - `screen_count_expected` integer, nullable
  - `screen_count_current` integer, nullable
  - `launch_window_start` string, date-time, nullable
  - `launch_window_end` string, date-time, nullable
  - `launch_window_cadence_s` integer, nullable
  - `archived` boolean, required
  - `percent_complete` number, required
  - `primary_sources_count` integer, required
  - `secondary_sources_count` integer, required
  - `primaries_count` integer, nullable
  - `secondaries_count` integer, nullable
  - `lowest_miss_distance_km` number, nullable
  - `highest_pc` number, nullable
  - `next_tca` string, date-time, nullable
  - `propagation_start_time` string, date-time, nullable
  - `propagation_duration_s` number, nullable
  - `propagation_timestep_s` number, nullable
  - `secondary_any_coverage_end` string, date-time, nullable
  - `secondary_any_coverage_start` string, date-time, nullable
  - `secondary_full_coverage_end` string, date-time, nullable
  - `secondary_full_coverage_start` string, date-time, nullable
  - `failure_message` string, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-26** `9a3b0a312528`: 1 info
  - added the required property `allow_synthetic_covariance` to the response with the `201` status
- **2026-09-11** `fba1aea33824`: 2 info
  - added the optional property `engine_used` to the response with the `201` status
  - added the required property `engine` to the response with the `201` status

[Operation history](https://skmtc.dev/satcat/apis/satcat-service-api/changes/conjunction_messages/:cdm_id/mitigation_scenarios/:scenario_id/screening/post.md)

---

[API](https://skmtc.dev/satcat/apis/satcat-service-api.md) - [All operations](https://skmtc.dev/satcat/apis/satcat-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/satcat/apis/satcat-service-api/revisions/7d8e32c7627f?raw)