{"type":"api","title":"List policies","meta":{"id":"/apps/pubhub/media/ai-defense-management-api/5e02ab7415425725ff5bd941112be2bb3794df69/262737b2-b3c2-32cd-b07b-fdbdcd23918f","info":{"title":"API for Cisco AI Defense platform services","description":"API for Cisco AI Defense platform services","version":"1.1.0","contact":{"name":"API Support","url":"https://www.cisco.com/site/us/en/products/security/ai-defense/index.html"},"license":{"name":"Apache 2.0","url":"http://www.apache.org/licenses/LICENSE-2.0.html"}},"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"Policies","description":"API endpoints for AI Defense policy management"},{"name":"Applications","description":"API endpoints for AI Defense application management"},{"name":"Connections","description":"API endpoints for AI Defense connection management"},{"name":"Events","description":"API endpoints for AI Defense runtime events management"},{"name":"AiValidationAPI"},{"name":"AwsCredentialsService"},{"name":"ScanManagerAPI"},{"name":"MCP Registry (Beta)"},{"name":"Resource Connections (Beta)","description":"API endpoints for AI Defense resource connection management"}],"x-parser-conf":{"overview":{"markdownPath":"reference/overview.md"}},"swagger":"2.0","host":"api.security.cisco.com","basePath":"/api/ai-defense/v1","schemes":["https"],"securityDefinitions":{"ApiKeyAuth":{"type":"apiKey","description":"API key for tenant authentication","name":"X-Cisco-AI-Defense-Tenant-API-Key","in":"header"}}},"spec":{"summary":"List policies","description":"Returns a paginated list of policies","operationId":"PoliciesService_ListPolicies","responses":{"200":{"description":"A successful response.","schema":{"type":"object","example":{"policies":{"items":[{"policy_id":"550e8400-e29b-41d4-a716-446655440000","policy_name":"Secure Access Policy","description":"Policy for securing GenAI access","status":"active","connection_type":"API","language_type":"English","created_at":"2025-04-01T00:00:00Z","updated_at":"2025-05-05T00:00:00Z"},{"policy_id":"660e8400-e29b-41d4-a716-446655440001","policy_name":"Data Privacy Policy","description":"Protection against data leakage","status":"active","connection_type":"Gateway","language_type":"English","created_at":"2025-04-10T00:00:00Z","updated_at":"2025-05-08T00:00:00Z"}],"paging":{"offset":0,"count":2,"total":10}}},"properties":{"policies":{"title":"List of policies with pagination","type":"object","example":{"items":[{"policy_id":"550e8400-e29b-41d4-a716-446655440000","policy_name":"Secure Access Policy"},{"policy_id":"660e8400-e29b-41d4-a716-446655440001","policy_name":"Data Privacy Policy"}],"paging":{"offset":0,"count":2,"total":10}},"properties":{"items":{"type":"array","items":{"type":"object","example":{"policy_id":"550e8400-e29b-41d4-a716-446655440000","policy_name":"Secure Access Policy","description":"Policy for securing GenAI access","status":"active","connection_type":"CONNECTION_TYPE_API","language_type":"English","created_at":"2025-04-01T00:00:00Z","updated_at":"2025-05-05T00:00:00Z"},"properties":{"policy_id":{"type":"string","description":"The policy_id string"},"policy_name":{"type":"string","description":"The policy_name string"},"description":{"type":"string","description":"The description string"},"status":{"type":"string","description":"The status string"},"connection_type":{"description":"The connection_type object","type":"string","enum":["Unspecified","API","Gateway","MCPGateway","MCPAPI"],"default":"Unspecified","title":"ConnectionType","$$ref":"#/definitions/v1ConnectionType"},"updated_at":{"type":"string","format":"date-time","description":"The updated_at string"},"created_at":{"type":"string","format":"date-time","description":"The created_at string"},"language_type":{"type":"string","description":"The language_type string"},"updated_by":{"type":"string","title":"Backward compatibility field containing user's full name","description":"Backward compatibility field containing user's full name"},"guardrails":{"title":"list of associated guardrails, will be populated on expanded requests","type":"object","example":{"items":[{"guardrails_type":"Security","items":[{"ruleset_type":"Prompt Injection","status":"Enabled","direction":"Prompt","action":"Block","entity":{"name":"Email Address","desc":"Email address of the user"}}]}],"paging":{"offset":0,"count":3,"total":3}},"properties":{"items":{"type":"array","items":{"type":"object","example":{"guardrails_type":"Security","items":[{"ruleset_type":"Prompt Injection","status":"Enabled","direction":"Prompt","action":"Block","entity":{"name":"Email Address","desc":"Email address of the user"}}],"paging":{"offset":0,"count":3,"total":3}},"properties":{"guardrails_type":{"title":"e.g., \"Security\", \"Privacy\", \"Safety\"","type":"string","enum":["GuardrailTypeUnspecified","Security","Privacy","Safety"],"default":"GuardrailTypeUnspecified","description":"Schema for v1GuardrailType","$$ref":"#/definitions/v1GuardrailType"},"items":{"type":"array","items":{"type":"object","example":{"ruleset_type":"Prompt Injection","status":"Enabled","direction":"Prompt","action":"Block","entity":{"name":"Email Address","desc":"Email address of the user"}},"properties":{"ruleset_type":{"type":"string","title":"e.g., \"Prompt Injection\", \"PII\"","description":"e.g., \"Prompt Injection\", \"PII\""},"status":{"title":"e.g., \"Enabled\", Disabled","type":"string","enum":["RuleStatusUnspecified","Enabled","Disabled"],"default":"RuleStatusUnspecified","description":"Schema for v1RuleStatus","$$ref":"#/definitions/v1RuleStatus"},"direction":{"title":"e.g., \"Prompt\", \"Response\", \"Both\"","type":"string","enum":["DirectionUnspecified","Prompt","Response","Both"],"default":"DirectionUnspecified","description":"Schema for v1Direction","$$ref":"#/definitions/v1Direction"},"action":{"title":"e.g., \"Block\", \"Allow\"","type":"string","enum":["ActionUnspecified","Block","Allow"],"default":"ActionUnspecified","description":"Schema for v1Action","$$ref":"#/definitions/v1Action"},"entity":{"title":"Entity associated with the ruleset","type":"object","example":{"name":"Email Address","desc":"Email address of the user"},"properties":{"name":{"type":"string","title":"e.g., \"Email Address\"","description":"e.g., \"Email Address\""},"desc":{"type":"string","title":"e.g., \"Email address of the user\"","description":"e.g., \"Email address of the user\""}},"description":"Entity information","$$ref":"#/definitions/v1Entity"}},"description":"Guardrail rule information","title":"GuardrailRule","$$ref":"#/definitions/v1GuardrailRule"},"title":"Nested entity associations","description":"Nested entity associations"},"paging":{"description":"The paging object","type":"object","example":{"offset":0,"count":10,"total":50},"properties":{"offset":{"type":"integer","format":"int64","title":"the offset from which the list starts","description":"the offset from which the list starts"},"count":{"type":"integer","format":"int64","title":"the number of items in the list","description":"the number of items in the list"},"total":{"type":"integer","format":"int64","title":"the total number of items in the backend","description":"the total number of items in the backend"}},"title":"Paging","$$ref":"#/definitions/ai_defenseconfig_mgr_public_rest_typesv1Paging"}},"description":"Guardrail information","title":"Guardrail","$$ref":"#/definitions/v1Guardrail"},"title":"Nested entity associations","description":"Nested entity associations"},"paging":{"description":"The paging object","type":"object","example":{"offset":0,"count":10,"total":50},"properties":{"offset":{"type":"integer","format":"int64","title":"the offset from which the list starts","description":"the offset from which the list starts"},"count":{"type":"integer","format":"int64","title":"the number of items in the list","description":"the number of items in the list"},"total":{"type":"integer","format":"int64","title":"the total number of items in the backend","description":"the total number of items in the backend"}},"title":"Paging","$$ref":"#/definitions/ai_defenseconfig_mgr_public_rest_typesv1Paging"}},"description":"List of guardrails","$$ref":"#/definitions/v1Guardrails"}},"description":"Policy information","title":"Policy","$$ref":"#/definitions/v1Policy"},"title":"List of policies","description":"List of policies"},"paging":{"title":"Pagination information","type":"object","example":{"offset":0,"count":10,"total":50},"properties":{"offset":{"type":"integer","format":"int64","title":"the offset from which the list starts","description":"the offset from which the list starts"},"count":{"type":"integer","format":"int64","title":"the number of items in the list","description":"the number of items in the list"},"total":{"type":"integer","format":"int64","title":"the total number of items in the backend","description":"the total number of items in the backend"}},"description":"Pagination details","$$ref":"#/definitions/ai_defenseconfig_mgr_public_rest_typesv1Paging"}},"description":"List of policies","$$ref":"#/definitions/v1Policies"}},"description":"List of policies with pagination","title":"ListPoliciesResponse","$$ref":"#/definitions/v1ListPoliciesResponse"}},"default":{"description":"An unexpected error response.","schema":{"type":"object","properties":{"code":{"type":"integer","format":"int32","description":"The code integer"},"message":{"type":"string","description":"The message string"},"details":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string","description":"The @type string"}},"additionalProperties":true,"description":"Contains additional error details specific to the operation","$$ref":"#/definitions/AdditionalErrorDetails"},"description":"The details array"}},"description":"Details about API errors including code, message, and additional details","example":{"code":13,"message":"Internal","details":[]},"$$ref":"#/definitions/ErrorDetails"}}},"parameters":[{"name":"limit","description":"Number of records to retrieve, default and max value is 100 (optional)","in":"query","required":false,"type":"integer","format":"int64"},{"name":"offset","description":"Offset for pagination (optional)","in":"query","required":false,"type":"integer","format":"int64"},{"name":"sort_by","description":"Field name to sort the policies returned (optional)","in":"query","required":false,"type":"string","enum":["PolicySortBy_Unspecified","policy_name"],"default":"PolicySortBy_Unspecified"},{"name":"order","description":"Sort order of the policies returned (optional)","in":"query","required":false,"type":"string","enum":["SortOrder_Unspecified","asc","desc"],"default":"SortOrder_Unspecified"},{"name":"language_type","description":"Filter by language type (optional)","in":"query","required":false,"type":"string","enum":["LanguageTypeUnspecified","English","Japanese","French","German"],"default":"LanguageTypeUnspecified"},{"name":"connection_type","description":"Filter by connection type (optional)","in":"query","required":false,"type":"string","enum":["Unspecified","API","Gateway","MCPGateway","MCPAPI"],"default":"Unspecified"},{"name":"policy_status","description":"Filter by policy status (optional)","in":"query","required":false,"type":"string","enum":["PolicyStatusUnspecified","Draft","Enabled","Disabled"],"default":"PolicyStatusUnspecified"},{"name":"policy_name","description":"Filter by policy name (optional)","in":"query","required":false,"type":"string"}],"tags":["Policies"],"__originalOperationId":"PoliciesService_ListPolicies","consumes":["application/json"],"produces":["application/json"],"security":[{"ApiKeyAuth":[]}],"method":"get","path":"/policies"}}