generated: '2026-07-15' method: generated source: openapi/soundstat-openapi.yml description: Recommended x-agentic-access execution contracts, classified heuristically from the OpenAPI. A governance starting point for exposing this API to AI agents — review and bind audience per deployment. See research/curity/agentic-governance/. summary: operations: 20 by_action_class: connected: 5 acting: 15 by_consequence: read: 5 write: 15 human_in_the_loop_required: 0 operations: - path: /api/v1/track/{track_id} method: get operationId: get_track_analysis_api_v1_track__track_id__get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/track/{track_id}/status method: get operationId: track_status_updates_api_v1_track__track_id__status_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/tracks/search method: post operationId: search_tracks_api_v1_tracks_search_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/genres method: get operationId: get_available_genres_api_v1_genres_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/recommendations/similar method: get operationId: get_similar_tracks_api_v1_recommendations_similar_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/recommendations/by-features method: post operationId: get_recommendations_by_features_api_v1_recommendations_by_features_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/recommendations/mixed method: post operationId: get_mixed_recommendations_api_v1_recommendations_mixed_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/stats method: get operationId: get_analysis_stats_api_v1_stats_get x-agentic-access: action-class: connected consequence: read subject: optional token: max-ttl: 3600 audit: none - path: /api/v1/recommendations/progression method: post operationId: get_progression_recommendations_api_v1_recommendations_progression_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/recommendations/compatible method: post operationId: get_compatible_tracks_api_v1_recommendations_compatible_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/recommendations/contrast method: post operationId: get_contrast_recommendations_api_v1_recommendations_contrast_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/recommendations/cross-genre method: post operationId: get_cross_genre_recommendations_api_v1_recommendations_cross_genre_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/recommendations/time-of-day method: post operationId: get_time_of_day_recommendations_api_v1_recommendations_time_of_day_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/recommendations/hidden-gems method: post operationId: get_hidden_gems_recommendations_api_v1_recommendations_hidden_gems_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/recommendations/beat-structure method: post operationId: get_beat_structure_recommendations_api_v1_recommendations_beat_structure_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/recommendations/duration method: post operationId: get_duration_recommendations_api_v1_recommendations_duration_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/recommendations/mood method: post operationId: get_mood_recommendations_api_v1_recommendations_mood_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/recommendations/activity method: post operationId: get_activity_recommendations_api_v1_recommendations_activity_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/recommendations/instrumental method: post operationId: get_instrumental_recommendations_api_v1_recommendations_instrumental_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required - path: /api/v1/recommendations/acoustic method: post operationId: get_acoustic_recommendations_api_v1_recommendations_acoustic_post x-agentic-access: action-class: acting consequence: write subject: required audience: null token: max-ttl: 900 escalation: human-in-the-loop: conditional triggers: - abnormal - high-value audit: required