Create a shadow or governed-review investment operation

Creates an evidence workflow only. Shadow mode can never hand off an action. Governed review still requires sealed evidence, an approved model portfolio and the existing human approval and execution control planes.

{
    "portfolio_id": "string",
    "mode": "shadow",
    "title": "string",
    "investment_thesis": "string",
    "thematic_universe_id": 1,
    "model_portfolio_id": 1,
    "synthetic_option_run_id": 1,
    "xva_snapshot_id": 1,
    "require_thematic": true,
    "require_theme_watch": true,
    "require_lqm": false,
    "require_generative_markets": true
}

curl

curl -X POST \
  -H "Authorization: Bearer $FINANCEGPT_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  --data '{
    "portfolio_id": "string",
    "mode": "shadow",
    "title": "string",
    "investment_thesis": "string",
    "thematic_universe_id": 1,
    "model_portfolio_id": 1,
    "synthetic_option_run_id": 1,
    "xva_snapshot_id": 1,
    "require_thematic": true,
    "require_theme_watch": true,
    "require_lqm": false,
    "require_generative_markets": true
}' \
  "https://financegpt.dev/api/v2/investment/governed-ai-operations"

javascript

const response = await fetch("https:\/\/financegpt.dev\/api\/v2\/investment\/governed-ai-operations", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${FINANCEGPT_API_KEY}`,
    Accept: 'application/json',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "portfolio_id": "string",
    "mode": "shadow",
    "title": "string",
    "investment_thesis": "string",
    "thematic_universe_id": 1,
    "model_portfolio_id": 1,
    "synthetic_option_run_id": 1,
    "xva_snapshot_id": 1,
    "require_thematic": true,
    "require_theme_watch": true,
    "require_lqm": false,
    "require_generative_markets": true
}),
});
const data = await response.json();

python

import json
import os
import requests

response = requests.request(
    'POST',
    'https://financegpt.dev/api/v2/investment/governed-ai-operations',
    headers={
        'Authorization': 'Bearer ' + os.environ['FINANCEGPT_API_KEY'],
        'Accept': 'application/json',
    },
    json=json.loads('{"portfolio_id":"string","mode":"shadow","title":"string","investment_thesis":"string","thematic_universe_id":1,"model_portfolio_id":1,"synthetic_option_run_id":1,"xva_snapshot_id":1,"require_thematic":true,"require_theme_watch":true,"require_lqm":false,"require_generative_markets":true}'),
)
response.raise_for_status()
print(response.json())

php

<?php
$ch = curl_init('https://financegpt.dev/api/v2/investment/governed-ai-operations');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer '.getenv('FINANCEGPT_API_KEY'),
        'Accept: application/json',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode(array (
  'portfolio_id' => 'string',
  'mode' => 'shadow',
  'title' => 'string',
  'investment_thesis' => 'string',
  'thematic_universe_id' => 1,
  'model_portfolio_id' => 1,
  'synthetic_option_run_id' => 1,
  'xva_snapshot_id' => 1,
  'require_thematic' => true,
  'require_theme_watch' => true,
  'require_lqm' => false,
  'require_generative_markets' => true,
)),
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

A developer credential proves application identity and permits only its scopes. It does not grant model promotion, policy override, QLM rebinding, or Financial Actions execution authority unless those separate controls are satisfied.

investment:run