Monitor Concepts

List monitor concepts

get

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

/v1/{workspace_id}/monitor-concepts/

List monitor concepts for the workspace.

Authorizations

BearerAuth

AuthorizationstringRequired

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

Query parameters

limitinteger · max: 20OptionalDefault: 10

continuation_tokenintegerOptionalDefault: 0

Responses

200

Successful Response

application/json

has_morebooleanRequired

continuation_tokenany ofOptional

integerOptional

or

nullOptional

401

Missing or invalid API key.

422

Validation Error

application/json

get

/v1/{workspace_id}/monitor-concepts/

HTTPcURLJavaScriptPython

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

{
  "items": [
    {
      "id": "text",
      "workspace_id": "text",
      "name": "text",
      "description": "text",
      "threshold": 1,
      "standalone_threshold": 1,
      "agent_config": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "escalation": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "tags": [
        "text"
      ],
      "has_embedding": true,
      "created_at": "2026-03-22T05:27:56.922Z",
      "updated_at": "2026-03-22T05:27:56.922Z"
    }
  ],
  "has_more": true,
  "continuation_token": 1
}

Create a monitor concept

post

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

/v1/{workspace_id}/monitor-concepts/

Create a semantic monitoring concept. The description is embedded for real-time conversation monitoring via ConversationMonitor.

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

namestringRequired

descriptionstringRequired

thresholdnumberOptionalDefault: 0.4

standalone_thresholdnumberOptionalDefault: 0.85

tagsstring[]Optional

Responses

201

Successful Response

application/json

401

Missing or invalid API key.

403

Insufficient permissions.

422

Validation Error

application/json

post

/v1/{workspace_id}/monitor-concepts/

HTTPcURLJavaScriptPython

POST /v1/{workspace_id}/monitor-concepts/ HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 302

{
  "name": "text",
  "description": "text",
  "threshold": 0.4,
  "standalone_threshold": 0.85,
  "agent_config": {
    "model": "gemini-2.5-flash",
    "system_prompt": "text",
    "timeout_s": 3,
    "action_space": [
      "text"
    ]
  },
  "escalation": {
    "operator_type": "crisis_counselor",
    "reason": "",
    "regulatory_basis": "",
    "immediate": true
  },
  "tags": [
    "text"
  ]
}

{
  "id": "text",
  "workspace_id": "text",
  "name": "text",
  "description": "text",
  "threshold": 1,
  "standalone_threshold": 1,
  "agent_config": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "escalation": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "tags": [
    "text"
  ],
  "has_embedding": true,
  "created_at": "2026-03-22T05:27:56.922Z",
  "updated_at": "2026-03-22T05:27:56.922Z"
}

Get a monitor concept

get

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

/v1/{workspace_id}/monitor-concepts/{concept_id}

Retrieve a monitor concept by ID.

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

concept_idstringRequired

Responses

200

Successful Response

application/json

idstringRequired

workspace_idstringRequired

namestringRequired

descriptionstringRequired

thresholdnumberRequired

standalone_thresholdnumberRequired

tagsstring[]Required

has_embeddingbooleanRequired

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

401

Missing or invalid API key.

404

Monitor concept not found.

422

Validation Error

application/json

get

/v1/{workspace_id}/monitor-concepts/{concept_id}

HTTPcURLJavaScriptPython

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

{
  "id": "text",
  "workspace_id": "text",
  "name": "text",
  "description": "text",
  "threshold": 1,
  "standalone_threshold": 1,
  "agent_config": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "escalation": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "tags": [
    "text"
  ],
  "has_embedding": true,
  "created_at": "2026-03-22T05:27:56.922Z",
  "updated_at": "2026-03-22T05:27:56.922Z"
}

Delete a monitor concept

delete

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

/v1/{workspace_id}/monitor-concepts/{concept_id}

Delete a monitor concept.

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

concept_idstringRequired

Responses

204

Successful Response

401

Missing or invalid API key.

404

Monitor concept not found.

422

Validation Error

application/json

delete

/v1/{workspace_id}/monitor-concepts/{concept_id}

HTTPcURLJavaScriptPython

DELETE /v1/{workspace_id}/monitor-concepts/{concept_id} HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Update a monitor concept

patch

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

/v1/{workspace_id}/monitor-concepts/{concept_id}

Update a monitor concept's configuration or description.

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

concept_idstringRequired

Body

application/json

nameany ofOptional

stringOptional

or

nullOptional

descriptionany ofOptional

stringOptional

or

nullOptional

thresholdany ofOptional

numberOptional

or

nullOptional

standalone_thresholdany ofOptional

numberOptional

or

nullOptional

agent_configany ofOptional

or

nullOptional

escalationany ofOptional

or

nullOptional

tagsany ofOptional

string[]Optional

or

nullOptional

Responses

200

Successful Response

application/json

idstringRequired

workspace_idstringRequired

namestringRequired

descriptionstringRequired

thresholdnumberRequired

standalone_thresholdnumberRequired

tagsstring[]Required

has_embeddingbooleanRequired

created_atstring · date-timeRequired

updated_atstring · date-timeRequired

401

Missing or invalid API key.

404

Monitor concept not found.

422

Validation Error

application/json

patch

/v1/{workspace_id}/monitor-concepts/{concept_id}

HTTPcURLJavaScriptPython

PATCH /v1/{workspace_id}/monitor-concepts/{concept_id} HTTP/1.1
Host: internal-api.platform.amigo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 297

{
  "name": "text",
  "description": "text",
  "threshold": 1,
  "standalone_threshold": 1,
  "agent_config": {
    "model": "gemini-2.5-flash",
    "system_prompt": "text",
    "timeout_s": 3,
    "action_space": [
      "text"
    ]
  },
  "escalation": {
    "operator_type": "crisis_counselor",
    "reason": "",
    "regulatory_basis": "",
    "immediate": true
  },
  "tags": [
    "text"
  ]
}

{
  "id": "text",
  "workspace_id": "text",
  "name": "text",
  "description": "text",
  "threshold": 1,
  "standalone_threshold": 1,
  "agent_config": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "escalation": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "tags": [
    "text"
  ],
  "has_embedding": true,
  "created_at": "2026-03-22T05:27:56.922Z",
  "updated_at": "2026-03-22T05:27:56.922Z"
}