# Monitor Concepts

## List monitor concepts

> List monitor concepts for the workspace.

```json
{"openapi":"3.1.0","info":{"title":"Platform API","version":"1.0.0"},"servers":[{"url":"https://api.platform.amigo.ai","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key issued via `POST /v1/{workspace_id}/api-keys`. Pass the returned `api_key` value as a Bearer token."}},"schemas":{"PaginatedResponse_MonitorConceptResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/MonitorConceptResponse"},"type":"array","title":"Items"},"has_more":{"type":"boolean","title":"Has More"},"continuation_token":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Continuation Token"},"total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total"}},"type":"object","required":["items","has_more"],"title":"PaginatedResponse[MonitorConceptResponse]"},"MonitorConceptResponse":{"properties":{"id":{"type":"string","title":"Id"},"workspace_id":{"type":"string","title":"Workspace Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"threshold":{"type":"number","title":"Threshold"},"standalone_threshold":{"type":"number","title":"Standalone Threshold"},"agent_config":{"additionalProperties":true,"type":"object","title":"Agent Config"},"escalation":{"additionalProperties":true,"type":"object","title":"Escalation"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"has_embedding":{"type":"boolean","title":"Has Embedding"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","workspace_id","name","description","threshold","standalone_threshold","agent_config","escalation","tags","has_embedding","created_at","updated_at"],"title":"MonitorConceptResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/v1/{workspace_id}/monitor-concepts":{"get":{"tags":["Monitor Concepts"],"summary":"List monitor concepts","description":"List monitor concepts for the workspace.","operationId":"list-monitor-concepts","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":20,"exclusiveMinimum":0,"default":10,"title":"Limit"}},{"name":"continuation_token","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Continuation Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginatedResponse_MonitorConceptResponse_"}}}},"401":{"description":"Missing or invalid API key."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Create a monitor concept

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

```json
{"openapi":"3.1.0","info":{"title":"Platform API","version":"1.0.0"},"servers":[{"url":"https://api.platform.amigo.ai","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key issued via `POST /v1/{workspace_id}/api-keys`. Pass the returned `api_key` value as a Bearer token."}},"schemas":{"CreateMonitorConceptRequest":{"properties":{"name":{"$ref":"#/components/schemas/NameString"},"description":{"$ref":"#/components/schemas/DescriptionString"},"threshold":{"type":"number","title":"Threshold","default":0.4},"standalone_threshold":{"type":"number","title":"Standalone Threshold","default":0.85},"agent_config":{"$ref":"#/components/schemas/AgentConfigPayload"},"escalation":{"$ref":"#/components/schemas/EscalationConfigPayload"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"}},"type":"object","required":["name","description"],"title":"CreateMonitorConceptRequest"},"NameString":{"type":"string","maxLength":256,"minLength":1},"DescriptionString":{"type":"string","maxLength":2000},"AgentConfigPayload":{"properties":{"model":{"type":"string","title":"Model","default":"gemini-2.5-flash"},"system_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"System Prompt"},"timeout_s":{"type":"number","title":"Timeout S","default":3},"action_space":{"items":{"type":"string"},"type":"array","title":"Action Space"}},"type":"object","title":"AgentConfigPayload"},"EscalationConfigPayload":{"properties":{"operator_type":{"type":"string","title":"Operator Type","default":"crisis_counselor"},"reason":{"type":"string","title":"Reason","default":""},"regulatory_basis":{"type":"string","title":"Regulatory Basis","default":""},"immediate":{"type":"boolean","title":"Immediate","default":true}},"type":"object","title":"EscalationConfigPayload"},"MonitorConceptResponse":{"properties":{"id":{"type":"string","title":"Id"},"workspace_id":{"type":"string","title":"Workspace Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"threshold":{"type":"number","title":"Threshold"},"standalone_threshold":{"type":"number","title":"Standalone Threshold"},"agent_config":{"additionalProperties":true,"type":"object","title":"Agent Config"},"escalation":{"additionalProperties":true,"type":"object","title":"Escalation"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"has_embedding":{"type":"boolean","title":"Has Embedding"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","workspace_id","name","description","threshold","standalone_threshold","agent_config","escalation","tags","has_embedding","created_at","updated_at"],"title":"MonitorConceptResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/v1/{workspace_id}/monitor-concepts":{"post":{"tags":["Monitor Concepts"],"summary":"Create a monitor concept","description":"Create a semantic monitoring concept. The description is embedded for real-time conversation monitoring via ConversationMonitor.","operationId":"create-monitor-concept","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMonitorConceptRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorConceptResponse"}}}},"401":{"description":"Missing or invalid API key."},"403":{"description":"Insufficient permissions."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Get a monitor concept

> Retrieve a monitor concept by ID.

```json
{"openapi":"3.1.0","info":{"title":"Platform API","version":"1.0.0"},"servers":[{"url":"https://api.platform.amigo.ai","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key issued via `POST /v1/{workspace_id}/api-keys`. Pass the returned `api_key` value as a Bearer token."}},"schemas":{"MonitorConceptResponse":{"properties":{"id":{"type":"string","title":"Id"},"workspace_id":{"type":"string","title":"Workspace Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"threshold":{"type":"number","title":"Threshold"},"standalone_threshold":{"type":"number","title":"Standalone Threshold"},"agent_config":{"additionalProperties":true,"type":"object","title":"Agent Config"},"escalation":{"additionalProperties":true,"type":"object","title":"Escalation"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"has_embedding":{"type":"boolean","title":"Has Embedding"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","workspace_id","name","description","threshold","standalone_threshold","agent_config","escalation","tags","has_embedding","created_at","updated_at"],"title":"MonitorConceptResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/v1/{workspace_id}/monitor-concepts/{concept_id}":{"get":{"tags":["Monitor Concepts"],"summary":"Get a monitor concept","description":"Retrieve a monitor concept by ID.","operationId":"get-monitor-concept","parameters":[{"name":"concept_id","in":"path","required":true,"schema":{"type":"string","title":"Concept Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorConceptResponse"}}}},"401":{"description":"Missing or invalid API key."},"404":{"description":"Monitor concept not found."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Delete a monitor concept

> Delete a monitor concept.

```json
{"openapi":"3.1.0","info":{"title":"Platform API","version":"1.0.0"},"servers":[{"url":"https://api.platform.amigo.ai","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key issued via `POST /v1/{workspace_id}/api-keys`. Pass the returned `api_key` value as a Bearer token."}},"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/v1/{workspace_id}/monitor-concepts/{concept_id}":{"delete":{"tags":["Monitor Concepts"],"summary":"Delete a monitor concept","description":"Delete a monitor concept.","operationId":"delete-monitor-concept","parameters":[{"name":"concept_id","in":"path","required":true,"schema":{"type":"string","title":"Concept Id"}}],"responses":{"204":{"description":"Successful Response"},"401":{"description":"Missing or invalid API key."},"404":{"description":"Monitor concept not found."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Update a monitor concept

> Update a monitor concept's configuration or description.

```json
{"openapi":"3.1.0","info":{"title":"Platform API","version":"1.0.0"},"servers":[{"url":"https://api.platform.amigo.ai","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"API key issued via `POST /v1/{workspace_id}/api-keys`. Pass the returned `api_key` value as a Bearer token."}},"schemas":{"UpdateMonitorConceptRequest":{"properties":{"name":{"anyOf":[{"$ref":"#/components/schemas/NameString"},{"type":"null"}]},"description":{"anyOf":[{"$ref":"#/components/schemas/DescriptionString"},{"type":"null"}]},"threshold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Threshold"},"standalone_threshold":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Standalone Threshold"},"agent_config":{"anyOf":[{"$ref":"#/components/schemas/AgentConfigPayload"},{"type":"null"}]},"escalation":{"anyOf":[{"$ref":"#/components/schemas/EscalationConfigPayload"},{"type":"null"}]},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"}},"type":"object","title":"UpdateMonitorConceptRequest"},"NameString":{"type":"string","maxLength":256,"minLength":1},"DescriptionString":{"type":"string","maxLength":2000},"AgentConfigPayload":{"properties":{"model":{"type":"string","title":"Model","default":"gemini-2.5-flash"},"system_prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"System Prompt"},"timeout_s":{"type":"number","title":"Timeout S","default":3},"action_space":{"items":{"type":"string"},"type":"array","title":"Action Space"}},"type":"object","title":"AgentConfigPayload"},"EscalationConfigPayload":{"properties":{"operator_type":{"type":"string","title":"Operator Type","default":"crisis_counselor"},"reason":{"type":"string","title":"Reason","default":""},"regulatory_basis":{"type":"string","title":"Regulatory Basis","default":""},"immediate":{"type":"boolean","title":"Immediate","default":true}},"type":"object","title":"EscalationConfigPayload"},"MonitorConceptResponse":{"properties":{"id":{"type":"string","title":"Id"},"workspace_id":{"type":"string","title":"Workspace Id"},"name":{"type":"string","title":"Name"},"description":{"type":"string","title":"Description"},"threshold":{"type":"number","title":"Threshold"},"standalone_threshold":{"type":"number","title":"Standalone Threshold"},"agent_config":{"additionalProperties":true,"type":"object","title":"Agent Config"},"escalation":{"additionalProperties":true,"type":"object","title":"Escalation"},"tags":{"items":{"type":"string"},"type":"array","title":"Tags"},"has_embedding":{"type":"boolean","title":"Has Embedding"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"type":"string","format":"date-time","title":"Updated At"}},"type":"object","required":["id","workspace_id","name","description","threshold","standalone_threshold","agent_config","escalation","tags","has_embedding","created_at","updated_at"],"title":"MonitorConceptResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/v1/{workspace_id}/monitor-concepts/{concept_id}":{"patch":{"tags":["Monitor Concepts"],"summary":"Update a monitor concept","description":"Update a monitor concept's configuration or description.","operationId":"update-monitor-concept","parameters":[{"name":"concept_id","in":"path","required":true,"schema":{"type":"string","title":"Concept Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMonitorConceptRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitorConceptResponse"}}}},"401":{"description":"Missing or invalid API key."},"404":{"description":"Monitor concept not found."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```