Skip to main content
POST
Create a saved risk launcher item.

Authorizations

Authorization
string
header
required

OAuth2 access-token requested from AWS Cognito and provided as a Auth Bearer header

Body

The body containing Item with its client-supplied saved-item Id, accessible report and portfolio names, optional portfolio type, reporting currency and market-data environment names, run date, optional portfolio date-time, real-time and run-date flags, optional report-run linkage, cutoff display name, and optional position-filter identifier or name. Date-time values use the documented date-time format.

Payload for creating a saved risk report launcher item.

$type
enum<string>
required
Available options:
Derivitec.Web.Core.ReportLauncher.ApiRiskReportLauncherItemCreateRequest, Derivitec.Web.Core
report_name
string | null

Organisation-scoped name of the report definition to use. The value must not be null or empty.

Example:

"Daily risk overview"

reporting_currency
string | null

Currency in which report values are expressed. When null, the service uses the caller's configured reporting currency or USD.

Example:

"USD"

market_data_environment_names
string[] | null

Names of market-data environments to use for the report. The list is empty by default.

portfolio_name
string | null

Name of the portfolio to select. The value must not be null or empty.

Example:

"Example portfolio"

portfolio_type
enum<string> | null

Portfolio category used to resolve the requested portfolio. It may be omitted when the portfolio name resolves unambiguously.

Available options:
derivitec,
enfusion,
orchestrade,
liquidity_book,
maia,
fund_studio,
not_set
item
object

Risk-report-specific saved report-launcher item.

Response

Returns whether the risk launcher item was saved and any validation or access errors in the response envelope.

Common operation outcome containing a success indicator and any error messages.

$type
enum<string>
required
Available options:
Derivitec.Web.Core.ApiBaseResponse, Derivitec.Web.Core
is_success
boolean

Whether the operation completed successfully. The default is true; error outcomes set it to false.

Example:

true

error_messages
string[] | null

Messages explaining operation-level failures. The collection is empty by default.