Safety

List regulation templates

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/safety/templates

List all available regulation templates and composite templates.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Responses

200

Successful Response

application/json

idstringRequired

namestringRequired

regulationstringRequired

descriptionstringRequired

categorystringRequired

versionstringRequired

is_compositebooleanOptionalDefault: false

template_idsstring[]Optional

401

Missing or invalid API key.

get

/v1/{workspace_id}/safety/templates

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/safety/templates HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "text",
    "name": "text",
    "regulation": "text",
    "description": "text",
    "category": "text",
    "version": "text",
    "rules": [
      {
        "name": "text",
        "description": "text",
        "triage_hints": [
          "text"
        ],
        "threshold": 1,
        "standalone_threshold": 1,
        "agent_config": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "escalation": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "tags": [
          "text"
        ]
      }
    ],
    "is_composite": false,
    "template_ids": [
      "text"
    ]
  }
]

Get a regulation template

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/safety/templates/{template_id}

Get a regulation template by ID, including all rules.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

template_idstringRequired

Responses

200

Successful Response

application/json

idstringRequired

namestringRequired

regulationstringRequired

descriptionstringRequired

categorystringRequired

versionstringRequired

is_compositebooleanOptionalDefault: false

template_idsstring[]Optional

401

Missing or invalid API key.

404

Template not found.

422

Validation Error

application/json

get

/v1/{workspace_id}/safety/templates/{template_id}

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/safety/templates/{template_id} HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "name": "text",
  "regulation": "text",
  "description": "text",
  "category": "text",
  "version": "text",
  "rules": [
    {
      "name": "text",
      "description": "text",
      "triage_hints": [
        "text"
      ],
      "threshold": 1,
      "standalone_threshold": 1,
      "agent_config": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "escalation": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "tags": [
        "text"
      ]
    }
  ],
  "is_composite": false,
  "template_ids": [
    "text"
  ]
}

Apply regulation template

post

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/safety/templates/{template_id}/apply

Apply a regulation template to create monitor concepts for the workspace. Concepts matching existing names are skipped unless override_existing is set.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Path parameters

template_idstringRequired

Body

application/json

override_existingbooleanOptionalDefault: false

Responses

200

Successful Response

application/json

created_conceptsstring[]Required

skippedstring[]Required

401

Missing or invalid API key.

404

Template not found.

422

Validation Error

application/json

post

/v1/{workspace_id}/safety/templates/{template_id}/apply

HTTPcURLJavaScriptPython

POST /v1/{workspace_id}/safety/templates/{template_id}/apply HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 27

{
  "override_existing": false
}

{
  "created_concepts": [
    "text"
  ],
  "skipped": [
    "text"
  ]
}

Get safety policy config

get

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/safety/config

Get the workspace safety policy configuration.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Responses

200

Successful Response

application/json

triage_enabledbooleanRequired

triage_modelstringRequired

triage_timeout_snumberRequired

triage_max_history_turnsintegerRequired

accumulation_enabledbooleanRequired

accumulation_window_sizeintegerRequired

accumulation_single_turn_thresholdintegerRequired

accumulation_cumulative_countintegerRequired

embedding_gate_enabledbooleanRequired

applied_template_idsstring[]Required

401

Missing or invalid API key.

get

/v1/{workspace_id}/safety/config

HTTPcURLJavaScriptPython

GET /v1/{workspace_id}/safety/config HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "triage_enabled": true,
  "triage_model": "text",
  "triage_timeout_s": 1,
  "triage_max_history_turns": 1,
  "accumulation_enabled": true,
  "accumulation_window_size": 1,
  "accumulation_single_turn_threshold": 1,
  "accumulation_cumulative_count": 1,
  "embedding_gate_enabled": true,
  "applied_template_ids": [
    "text"
  ]
}

Update safety policy config

put

https://internal-api.platform.amigo.aihttps://api.platform.amigo.ai

/v1/{workspace_id}/safety/config

Upsert the workspace safety policy configuration.

Authorizations

BearerAuth

AuthorizationstringRequired

API key issued via POST /v1/{workspace_id}/api-keys. Pass the returned api_key value as a Bearer token.

Body

application/json

triage_enabledany ofOptional

booleanOptional

or

nullOptional

triage_modelany ofOptional

stringOptional

or

nullOptional

triage_timeout_sany ofOptional

numberOptional

or

nullOptional

triage_max_history_turnsany ofOptional

integerOptional

or

nullOptional

accumulation_enabledany ofOptional

booleanOptional

or

nullOptional

accumulation_window_sizeany ofOptional

integerOptional

or

nullOptional

accumulation_single_turn_thresholdany ofOptional

integerOptional

or

nullOptional

accumulation_cumulative_countany ofOptional

integerOptional

or

nullOptional

embedding_gate_enabledany ofOptional

booleanOptional

or

nullOptional

Responses

200

Successful Response

application/json

triage_enabledbooleanRequired

triage_modelstringRequired

triage_timeout_snumberRequired

triage_max_history_turnsintegerRequired

accumulation_enabledbooleanRequired

accumulation_window_sizeintegerRequired

accumulation_single_turn_thresholdintegerRequired

accumulation_cumulative_countintegerRequired

embedding_gate_enabledbooleanRequired

applied_template_idsstring[]Required

401

Missing or invalid API key.

422

Validation Error

application/json

put

/v1/{workspace_id}/safety/config

HTTPcURLJavaScriptPython

PUT /v1/{workspace_id}/safety/config HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 255

{
  "triage_enabled": true,
  "triage_model": "text",
  "triage_timeout_s": 1,
  "triage_max_history_turns": 1,
  "accumulation_enabled": true,
  "accumulation_window_size": 1,
  "accumulation_single_turn_threshold": 1,
  "accumulation_cumulative_count": 1,
  "embedding_gate_enabled": true
}

{
  "triage_enabled": true,
  "triage_model": "text",
  "triage_timeout_s": 1,
  "triage_max_history_turns": 1,
  "accumulation_enabled": true,
  "accumulation_window_size": 1,
  "accumulation_single_turn_threshold": 1,
  "accumulation_cumulative_count": 1,
  "embedding_gate_enabled": true,
  "applied_template_ids": [
    "text"
  ]
}