accept_aod_run
ChatGPTAccept an AOD run (user review action), optionally recording a reason.
add_station_to_group
ChatGPTAdd a single station to a station group.
assign_social_connection_to_station
ChatGPTAssign a social platform connection to a station.
check_audit_audio_group
ChatGPTCheck if a reference audio exists for a stations group by customId and/or MD5. At least one of custom_id or md5 must be provided. A STATIONS_GROUP_AUDIO is inherited by all stations in the group — check this level before concluding a fingerprint is missing.
check_audit_audio_station
ChatGPTAlias of get_audit_spot_media_by_custom_id / get_audit_spot_media_by_md5. Kept for ChatGPT / older clients. Prefer the get_audit_spot_media_by_* tools. At least one of custom_id or md5 is required. Returns a page with the matching media, or an empty data array if not found.
check_auth
ChatGPTValidate the current credentials against the API gateway.
check_my_permission
ChatGPTCheck whether the current user/credentials hold a specific permission.
clone_asset
ChatGPTClone an asset — creates a new storage object and a new asset record.
clone_logger_fragment
ChatGPTClone an existing fragment under a new title.
clone_report_definition
ChatGPTClone an existing report definition.
clone_video_edit
ChatGPTClone a video editor edit (project) under a new name.
create_ai_content
ChatGPTCreate a new AI content entry.
create_aod_rule
ChatGPTCreate a new AOD rule. TIP: fetch an existing rule with get_aod_rule to see the full shape of reportConfig / exportConditions before creating one.
create_asset_upload_grant
ChatGPTCreate an out-of-band upload grant for MCP file uploads (POST /assets/v1/upload-grants). Do NOT send file bytes through any MCP tool argument — there is no PUT URL and no multipart upload from the agent. Flow for all hosts (Cursor, Claude, ChatGPT): 1. Call this tool (no file content). 2. Show uploadPageUrl to the human as a clickable link; they drop the file in the browser (no API key needed on that page). 3. Poll get_asset_upload_grant(grantId) until status is ready (or expired / failed — then create a new grant). 4. Use assets[0].asset.url as source_url on a domain tool (e.g. upload_audit_spot_media). v1 allows exactly one file per grant.
create_audit_report
ChatGPTCreate a persisted report of the given type. Unlike the results tools (which return data inline), this stores a report that can later be exported (export URLs, evidence packages).
create_audit_schedules_bulk
ChatGPTCreate audit schedule entries in bulk for a station. Each entry programs a spot or mention: customId (spot media key), datetime (UTC), type SPOT or MENTION, and optional tolerances in minutes (default to the client's configured values).
create_logger_fragment
ChatGPTCreate a new clip/fragment for a station.
create_manual_mention_match
ChatGPTCreate a manual mention match for a station. Use this to register a mention that was aired but not detected automatically. Returns the created match entity.
create_manual_spot_match
ChatGPTCreate a manual spot match for a station. Use this to register a spot that aired but was not detected automatically by the recognition engine.
create_media_export_job
ChatGPTEnqueue an async media export job for recorded stream audio/video. The job runs in the background — poll get_media_export_job for its status and the resulting download URL.
create_mention_date_schedules_batch
ChatGPTCreate mention date schedules in batch for a station. NOTE: the request body shape is not documented in the audit-mentions spec — schedules is passed through as-is. Verify the expected entry format with backend before relying on this tool.
create_report_definition
ChatGPTCreate a new report definition for a report type.
create_rudo_folder
ChatGPTCreate a Rudo folder for a connection (usable as an upload destination).
create_station_group
ChatGPTCreate a new station group, optionally assigning stations to it.
create_user
ChatGPTCreate a new user for the current client.
create_user_group
ChatGPTCreate a new user group, optionally assigning users to it.
create_video_composition
ChatGPTCreate a video composition.
create_video_edit
ChatGPTCreate a video editor edit (project) from a source.
create_video_template
ChatGPTCreate a video editor template.
delete_aod_rule
ChatGPTDelete an AOD rule. This cannot be undone.
delete_api_credential
ChatGPTDelete (revoke) an API credential. This cannot be undone — clients using it lose access immediately.
delete_asset
ChatGPTDelete an asset (storage object and record). This cannot be undone.
delete_audit_schedule
ChatGPTDelete a single audit schedule entry by ID. This cannot be undone. Prefer this over delete_audit_schedules_bulk when removing a known schedule instead of wiping a full datetime range.
delete_audit_schedules_bulk
ChatGPTDelete ALL audit schedule entries for a station within a datetime interval. This cannot be undone — every schedule whose datetime falls in [from_date, to_date] is removed. Prefer delete_audit_schedule or delete_audit_schedules_by_ids when you know the specific IDs.
delete_audit_schedules_by_ids
ChatGPTDelete one or more audit schedule entries by ID. This cannot be undone. Pass the schedule UUIDs returned by list_audit_schedules / get_audit_schedule / create_audit_schedules_bulk.
delete_audit_spot_media
ChatGPTDelete spot media by its media UUID. This cannot be undone.
delete_audit_support_files
ChatGPTDelete one or more uploaded audit-support log files by ID. This cannot be undone.
delete_logger_fragment
ChatGPTDelete a clip/fragment by ID. This cannot be undone.
delete_mention_match
ChatGPTDelete a mention match by ID. This cannot be undone.
delete_music_detection
ChatGPTDelete a music detection (e.g. a false positive). This cannot be undone.
delete_report_definition
ChatGPTDelete a report definition. This cannot be undone.
delete_social_connection
ChatGPTDelete a social platform connection. This cannot be undone — the platform must be re-authorized (OAuth) to reconnect.
delete_social_upload
ChatGPTDelete an upload — this removes the video from the social platform itself. Cannot be undone.
delete_station_group
ChatGPTDelete a station group. This cannot be undone (member stations are not deleted).
delete_user
ChatGPTDelete a user. This cannot be undone.
delete_user_group
ChatGPTDelete a user group. This cannot be undone (member users are not deleted).
delete_video_composition
ChatGPTDelete a video composition. This cannot be undone.
delete_video_edit
ChatGPTDelete a video editor edit (project). This cannot be undone.
delete_video_template
ChatGPTDelete a video editor template. This cannot be undone.
enable_fragment_delivery
ChatGPTEnable delivery for an existing fragment (clip).
export_aod_rules
ChatGPTExport AOD rules as JSON or CSV text (xls excluded — binary).
export_aod_runs
ChatGPTExport AOD runs as JSON or CSV text (xls excluded — binary).
export_logger_fragments
ChatGPTExport a station's fragments as JSON or CSV text.
export_media_frame
ChatGPTExtract one video frame from a station recording at a timestamp.
export_media_frames
ChatGPTExtract multiple video frames and return them as individual images. Timestamps without video are omitted by the API. The result is empty only when none of the requested timestamps have video media.
generate_ai_articles
ChatGPTGenerate AI articles for a content from its media analysis.
generate_ai_social_version
ChatGPTGenerate an adapted social version of the content for the target platform.
generate_gip_alt_report
ChatGPTGenerate a GIP Alternative report (variant of the GIP compliance report). Takes the same request shape as generate_gip_report — build the body the same way (see that tool's workflow) and pass it here.
generate_gip_report
ChatGPTGenerate a GIP (Gestión de Impacto Publicitario) compliance report. The GIP report matches scheduled ad spots against actual detections for a given time period and set of stations, returning efficiency metrics per order/campaign. WORKFLOW — before calling this tool: 1. Call get_gip_params_for_order(order_id) to get stationsIds, schedulesRange, audiosInfo, and client_id context for the order. 2. Use schedulesRange.from / .to as from_date / to_date. 3. Use stationsIds as station_ids. 4. Use the order_id as orders=[order_id]. The client_id can be obtained from list_stations — it appears as clientId on every station object. Constraints: - Date range cannot exceed 3 months. - If both station_ids and station_group_id are omitted (empty), the range must not exceed 24 hours. - station_ids and station_group_id are mutually exclusive. Set compact to true for diagnostics to omit detailed matchedSchedules while preserving meta.totals.matched and all deficiency data.
generate_matches_report
ChatGPTGenerate a BCR-matches or LTX-matches report: imported external log entries (DALLET / LTX) matched against detections for a station and day.
generate_report_preview
ChatGPTGenerate a CSV preview of a report definition (returns CSV text). XLS preview is excluded — binary output doesn't fit an MCP response.
get_ad_overlay_image
ChatGPTScreenshot of one detected ad overlay, returned as a native MCP image block (viewable in the conversation). Locate the entry with get_ad_overlays first, then call this with a narrow from/to around its date; the first matching entry with an image is returned.
get_ad_overlays
ChatGPTAd overlays (graphic ads detected on screen) for a station in a time range, with brand, date and duration. image_b64 payloads are stripped from the response (base64 images are not usable over MCP and blow past token limits) — entry metadata is kept intact.
get_ai_content
ChatGPTGet a single AI content by ID, including generated articles and social versions.
get_ai_content_by_key
ChatGPTGet a single AI content by its key instead of its ID.
get_aod_rule
ChatGPTGet a single AOD rule by ID, including its report config and export conditions.
get_aod_rule_variations
ChatGPTGet the order variations (date spans) for an AOD rule. Each variation represents one order's active campaign interval that the rule will process. Useful to see what orders and date ranges a rule covers.
get_aod_run
ChatGPTGet a single AOD run by ID, including its job statuses (process and reprocess). Returns full run details: status, efficiency, statusData, linked rule, processJobStatus, reprocessJobStatus, and computed flags (canRestart, canRefresh, canAccept, canReprocess, isPending, isCompleted, isFailed).
get_aod_run_process_status
ChatGPTGet the process job status (report generation) for an AOD run.
get_aod_run_reprocess_status
ChatGPTGet the Olaf reprocess job status for an AOD run.
get_api_credential
ChatGPTGet a single registered API credential (metadata only).
get_asset
ChatGPTGet a single asset by ID.
get_asset_upload_grant
ChatGPTPoll an upload grant until the human finishes uploading (GET /assets/v1/upload-grants/{grantId}). While pending, status is pending and assets is empty. When status is ready, use assets[0].asset.url as source_url for domain tools. uploadPageUrl is NOT returned on poll (only on create). Terminal states: ready, expired, failed.
get_audio_quality_issues
ChatGPTList raw audio quality issues detected in a time window. Returns individual issue segments with: - stationId: which station - kind: 'silent' (audio dropout) or 'poor_quality' (degraded signal) - start / end: ISO 8601 timestamps of the issue - durationSeconds: length of the issue - avgSilenceRatio: average silence ratio (null if not applicable) - avgQualityScore: average quality score (null if not applicable) Use this for targeted audio health queries. For a full report including stream gaps and KPIs, use get_stream_quality_report instead.
get_audit_advertisers
ChatGPTGet the list of advertiser names available for the client's audit schedules.
get_audit_campaigns
ChatGPTGet the list of campaign names available for the client's audit schedules.
get_audit_custom_fields
ChatGPTGet the custom fields configured for ASC upload entries for this client.
get_audit_mention_match
ChatGPTGet a single mention match by ID. The backend requires the station as a query parameter (even though the match ID is globally unique) — confirmed against prod 2026-07-31.
get_audit_schedule
ChatGPTGet a single audit schedule entry by ID.
get_audit_spot_media_by_custom_id
ChatGPTGet spot media metadata by customId. Uses GET /audit-spot/v1/media/by-custom-id (station-owned media, plus group-inherited media when inheritAudios is on). Returns the media object, or null if not found.
get_audit_spot_media_by_md5
ChatGPTGet spot media metadata by file MD5. Uses GET /audit-spot/v1/media/by-md5 (station-owned media, plus group-inherited media when inheritAudios is on). Returns the media object, or null if not found.
get_audit_spot_media_file
ChatGPTDownload the original spot media file by its media UUID. Uses GET /audit-spot/v1/media/{id}/file. Prefer this when you already have the media UUID from list/get; otherwise use get_audit_spot_media_file_by_custom_id / _by_md5.
get_audit_spot_media_file_by_custom_id
ChatGPTDownload the original spot media file by customId. Uses GET /audit-spot/v1/media/by-custom-id/file. Prefer this over create_logger_fragment for temporary listening/analysis.
get_audit_spot_media_file_by_md5
ChatGPTDownload the original spot media file by MD5. Uses GET /audit-spot/v1/media/by-md5/file. Prefer this over create_logger_fragment for temporary listening/analysis.
get_audit_spot_media_transcription
ChatGPTGet the transcription of spot media by its media UUID.
get_audit_support_entry
ChatGPTGet a single imported audit-support log entry by ID.
get_audit_support_file
ChatGPTGet a single uploaded audit-support log file by ID, with its import metadata.
get_audit_versions
ChatGPTGet the list of version names available for the client's audit schedules.
get_client_settings
ChatGPTGet a module's settings for a client (feature configuration client-wide).
get_content_ai_station_config
ChatGPTGet the content-ai configuration for a station.
get_context
ChatGPTReturn the operational knowledge base for Mediainbox: data models, matching engine rules, query patterns, tool usage guidelines, and logger link construction. Call this at the start of any session to load domain context.
get_current_time
ChatGPTReturn the current UTC date and time as an ISO-8601 string.
get_default_report_definition
ChatGPTGet the default report definition for a report type.
get_delivery_station_config
ChatGPTGet the fragments-delivery configuration for a station.
get_delivery_station_config_metadata
ChatGPTGet the fragments-delivery station config metadata (field descriptions, types).
get_fragment_delivery_status
ChatGPTGet the delivery status of a single fragment (clip).
get_fragments_delivery_bulk_status
ChatGPTGet the delivery status for multiple fragments at once (read-only query via POST).
get_gip_advertisers
ChatGPTAdvertisers present in GIP data, scoped by stations and date range.
get_gip_campaigns
ChatGPTCampaigns present in GIP data, scoped by stations, date range and advertisers.
get_gip_params_for_order
ChatGPTGet GIP audit parameters for one or more orders. USE THIS FIRST when analyzing an order (missing spots, unmatched detections, etc.). Returns the exact stations, audio customIds, and schedule date range for the order — so you know where and when to query before calling list_audit_schedules or list_spot_matches. Response fields: - stationsIds: list of station UUIDs that have schedules for this order - audiosInfo: list of {customId, audioId} for the spot media used - schedulesRange.from / .to: UTC date range covering all schedules - advertisers, campaigns, versions: context metadata
get_gip_report_custom_fields
ChatGPTCustom fields available on GIP report entries.
get_gip_versions
ChatGPTVersions present in GIP data, scoped by stations, dates, advertisers and campaigns.
get_hls_clip_playlist
ChatGPTGet a clipped VOD HLS (.m3u8) playlist covering only a time range. Unlike get_hls_playlist, partial first/last segments are trimmed at the edges instead of returned in full. Not supported for fMP4 stations.
get_hls_live_event_playlist
ChatGPTGet a live event HLS (.m3u8) playlist starting from a given time.
get_hls_live_playlist
ChatGPTGet the continuous live HLS (.m3u8) playlist for a station.
get_hls_playlist
ChatGPTGet the VOD HLS (.m3u8) playlist for a station and time range. Returns the playlist text — useful to build playback URLs or inspect which media segments cover the window.
get_latest_live_topics
ChatGPTRetrieve the most recent NLP-detected live topics for a channel. Useful for getting a quick snapshot of what is currently being discussed without specifying a time range. Each topic includes logger_url — the CloudLogger web player link to listen to that moment.
get_live_topic
ChatGPTRetrieve a single NLP-detected live topic by ID. Returns full detail including: - canonical_title, summary, category, key_points - refined_title, refined_summary, refined_key_points (post-refinement versions) - is_refined: whether the topic went through the refinement process - is_open: whether the topic is still being updated (new segments may extend it) - entities: named entities detected (people, orgs, places, etc.) - associated_to: linked entity or mention if applicable - start_time / end_time: ISO 8601 timestamps of the topic's broadcast window - logger_url: CloudLogger web player link to listen to the topic's start
get_live_topics
ChatGPTRetrieve NLP-detected live topics for a channel within a datetime range. Use this to enrich search results with thematic context: after any segment search, call this tool with the same slug and time range to surface related topics discussed on that channel during that period. Each topic includes logger_url — the CloudLogger web player link to listen to that moment; use it directly instead of deriving playback URLs from segments.
get_live_topics_state
ChatGPTRetrieve the live topics processing state for a channel. Returns cursor position, lock info, recent topic IDs, and failure tracking. Useful to check if the NLP pipeline is active and up to date.
get_logger_fragment
ChatGPTGet the details of a specific fragment by its ID.
get_logger_fragment_media_url
ChatGPTGet the signed URL for a fragment's audio/video asset. Uses the dedicated /assets endpoint — its entries carry the public CDN url, which the fragment's joined assets relation omits.
get_logger_fragment_subtitles
ChatGPTGet a fragment's transcription as subtitles (srt/vtt/csv/txt text, or json).
get_logger_fragment_transcription
ChatGPTGet the transcription of a fragment (if one was generated).
get_lowerthirds
ChatGPTLowerthirds (on-screen graphics/zócalos) shown on a station in a time range.
get_media_export_job
ChatGPTGet a media export job by ID (status, progress, download URL when done).
get_mention_date_schedule
ChatGPTGet a single mention date schedule by ID.
get_mention_schedule_status_report
ChatGPTGet the mention schedule status report for a station and date. Shows compliance of the day's mention schedule: which scheduled mentions were matched and which are still pending/missing.
get_music_detection
ChatGPTGet full detail for a single music detection, including track, artist, and genre info.
get_my_permissions
ChatGPTGet the permissions of the currently authenticated user/credentials.
get_olaf_reprocess_job_status
ChatGPTGet the status of an Olaf reprocess job by its job ID. Returns the full PublicJobDto with state (active/waiting/completed/failed), progress (0-100), and result or error details.
get_olaf_reprocess_status_by_key
ChatGPTGet the most recent Olaf reprocess job status by its reprocess key. Useful when you triggered the job with a known reprocessKey and want to check status without storing the jobId. Raises 404 if not found.
get_olaf_reprocess_status_by_order
ChatGPTGet the most recent Olaf reprocess job status for a given order ID (or set of order IDs). Searches across active, waiting, completed, and failed jobs. Raises 404 if no job is found for the given order(s).
get_permissions_catalog
ChatGPTGet the full catalog of permissions available in the platform.
get_report_blueprint
ChatGPTGet the blueprint metadata for a report type — the available fields, sections and options a report definition can configure.
get_report_definition
ChatGPTGet a report definition by ID.
get_report_evidence_export_url
ChatGPTGet the download URL for a persisted report's evidence package.
get_report_export_status
ChatGPTGet the export job status for a persisted report.
get_report_export_url
ChatGPTGet the download URL for a persisted report's export file.
get_screenbugs
ChatGPTScreenbugs (channel logo/watermark detections on screen) for a station in a time range.
get_segment_info
ChatGPTGet info for a single recorded segment by its timestamp. Waveform is excluded by default to keep the response small.
get_segment_thumbnail
ChatGPTGet the thumbnail for a single video segment.
get_segment_waveform
ChatGPTGet the waveform data for a single segment. WARNING: large response.
get_segments_recovery_job
ChatGPTGet the status of a segments recovery job (audio re-upload) by its job ID. Recovery jobs are created from the web UI by uploading an audio file for a window with missing segments; this tool tracks their progress.
get_segments_sequence
ChatGPTGet a contiguous sequence of segments starting from a timestamp. Useful to see how far uninterrupted recording extends from a given point.
get_segments_status
ChatGPTGet the segmenter (recording pipeline) status per station. Reliable substitute for the legacy station status endpoint: shows whether each station is currently capturing segments.
get_social_connection
ChatGPTGet a social platform connection by its ID.
get_social_connection_settings
ChatGPTGet the settings of a social platform connection.
get_social_upload
ChatGPTGet a social upload by ID (status, platform, target URL, etc.).
get_social_upload_platform_features
ChatGPTGet the platform features available for an upload (e.g. privacy levels, comments toggle).
get_social_uploads_by_key
ChatGPTGet uploads by key, optionally scoped to a single platform.
get_social_uploads_status
ChatGPTGet uploads status — all uploads for a platform, or by a list of keys.
get_station
ChatGPTGet full station details: name, slug, format, language, timezone, streams and features.
get_station_group
ChatGPTGet a single station group with its member stations.
get_station_groups_for_station
ChatGPTList all groups that a specific station belongs to.
get_station_programming
ChatGPTGet the current programming schedule for a station.
get_station_settings
ChatGPTGet a module's settings for a station (feature configuration per station).
get_station_social_connections
ChatGPTList the social platform connections assigned to a station.
get_station_status
ChatGPTGet the current capture status for a single station. Backed by the segments service (the legacy /stations/{station}/status endpoint was removed from the API). Shows whether the station is currently recording segments. For all stations at once, use get_segments_status.
get_stream_gaps
ChatGPTList stored stream gaps (periods with no captured audio) in a window. Direct signal for step 3 of the missing-spot checklist: if a gap covers the expected airtime, the spot could not have been detected.
get_stream_quality_report
ChatGPTGenerate a stream quality report covering stream gaps and audio quality issues. Returns per-station breakdown with: - Stream gaps: start/end times, duration in ms - Audio quality issues: kind ('silent' or 'poor_quality'), start/end, duration, scores - Global KPIs: total gaps, total gap duration, affected station rate Use station_slugs to narrow the report to specific stations.
get_tiktok_creator_info
ChatGPTGet TikTok creator info for a connection (posting limits, privacy options, etc.).
get_transcription_timeline
ChatGPTGet the raw transcription timeline for a station in a time range — the full transcribed text stream, without a search query.
get_user
ChatGPTGet a single user by ID.
get_user_group
ChatGPTGet a single user group by ID.
get_video_composition
ChatGPTGet a single video composition by ID.
get_video_edit
ChatGPTGet a video editor edit (project) by ID.
get_video_edit_render_status
ChatGPTGet the render status for a video edit.
get_video_edit_video_url
ChatGPTGet signed playback and download URLs for a video edit's rendered video.
get_video_template
ChatGPTGet a single video editor template by ID.
get_youtube_capabilities
ChatGPTGet the capabilities of a YouTube connection.
get_youtube_categories
ChatGPTGet the YouTube video categories available for a connection.
get_youtube_country_viewer_stats
ChatGPTGet YouTube viewer stats broken down by country for a station in a range.
get_youtube_cuepoint
ChatGPTGet a single inserted YouTube cuepoint, including the YouTube API response.
get_youtube_viewer_stats
ChatGPTGet YouTube concurrent viewer stats for a station's own broadcasts in a range.
import_mention_schedules_csv
ChatGPTImport mention date schedules from a CSV for a station. Validate first with validate_mention_schedules_csv. NOTE: the upload format is not documented in the audit-mentions spec — sent as multipart field 'file'. Verify with backend on first use.
insert_youtube_cuepoint
ChatGPTInsert an ad cuepoint into the station's live YouTube broadcast. This triggers a real ad break on the live stream — the channel and live video are resolved from the station's YouTube settings.
list_ai_contents
ChatGPTList AI contents (media analyses and generated articles) for the client.
list_aod_rules
ChatGPTList AOD (Automated On-Demand) rules configured for the client. AOD rules define automated report generation: which report type to run, which stations/orders to cover, when to trigger, and export conditions.
list_aod_runs
ChatGPTList AOD run executions for the client. AOD runs are individual executions of an AOD rule — each one processes a report and optionally exports evidence. Filterable by status, type, order, rule, and user review status.
list_aod_scheduled_runs
ChatGPTList all upcoming (future) scheduled AOD runs for the client. Returns enqueued BullMQ jobs that represent future automatic rule executions, with their scheduled datetime and rule info. Useful to see when the next automated report run will fire.
list_api_credentials
ChatGPTList registered API credentials (metadata only — no secret material).
list_assets
ChatGPTList uploaded assets (images, media files) for the client.
list_audit_audios
ChatGPTAlias of list_audit_spot_media (kept for ChatGPT / older clients). Prefer list_audit_spot_media. WARNING: can return 24 000+ entries — use get_audit_spot_media_by_custom_id / get_audit_spot_media_by_md5 (or the check_audit_audio_* aliases) for a single lookup.
list_audit_schedules
ChatGPTList scheduled ad entries (spots and mentions) for a station, with pagination and filtering.
list_audit_spot_media
ChatGPTList uploaded spot media for a station used in spot recognition. WARNING: Can return 24 000+ entries for large stations. Avoid full pagination — use get_audit_spot_media_by_custom_id / get_audit_spot_media_by_md5 to look up specific media instead.
list_audit_support_entries
ChatGPTList imported audit-support log entries (AVG, BCR or LTX). BCR entries are broadcast results imported from DALLET; AVG and LTX are the other supported external log formats.
list_audit_support_files
ChatGPTList uploaded audit-support log files (AVG, BCR or LTX) with their import metadata. Each file is the source of its imported entries.
list_delivery_station_configs
ChatGPTList the fragments-delivery configuration of all stations for the client.
list_fmp4_sessions
ChatGPTList fMP4 recording sessions for a station in a time range.
list_fragments
ChatGPTList clips/fragments from the web API with pagination, filtering and sorting. Filterable fields: stationId, createdAt range, mediaType (AUDIO/VIDEO), type (DEFAULT_FRAGMENT/JOINT_FRAGMENT), title (partial match), Content AI presence, external delivery presence, published platforms. Returns paginated results with total count.
list_live_mention_matches
ChatGPTList live mention matches for a station — matches between scheduled mentions and detected broadcast transcriptions, with confirmation status.
list_logger_fragment_assets
ChatGPTList the media assets (audio, video, poster, ...) of a fragment.
list_logger_fragments
ChatGPTList saved clips/fragments for a station with pagination. Use created_from / created_to to filter by creation date. Use from_date / to_date to filter by the clip's broadcast content window. Returns paginated results with total count.
list_media_export_jobs
ChatGPTList media export jobs (async audio/video exports of recorded streams).
list_mention_date_schedules
ChatGPTList mention date schedules for a station on a given date. A mention date schedule defines which mentions are expected to air on that date (the programmed side that mention matches are checked against).
list_music_detections
ChatGPTList music detections for a station within a time range. Returns track detections with artist, title, genre, detected timestamp, duration played, and confidence score.
list_report_definitions
ChatGPTList all report definitions (export layout/branding configs) for the client.
list_rudo_folders
ChatGPTList Rudo folders available for a connection (upload destination folders).
list_segment_thumbnails
ChatGPTList video thumbnails for a station's segments in a time range.
list_segments
ChatGPTList recorded stream segments for a station in a time range. Useful to verify whether audio was actually captured for a window (e.g. when diagnosing a missing spot match). Waveform data is excluded to keep responses small. Set basic=true for the lightest response (basic fields only, no media URLs).
list_social_connection_stations
ChatGPTList the station IDs assigned to a social platform connection.
list_social_connections
ChatGPTList all social platform connections for the client, optionally filtered by platform. Connections are client-level and identified by connection ID; stations are assigned to them.
list_spot_matches
ChatGPTList audit spot match results for a station. Filter custom_id against the detected audio's customId. Inspect matchedSchedule.order to determine which order claimed a detection. Sort accepts only datetime,ASC or datetime,DESC.
list_station_groups
ChatGPTList all station groups for the current client. Station groups are logical groupings of stations (e.g. by region or network). Useful for filtering stream quality reports or batch queries.
list_stations
ChatGPTList all stations/channels available for the current client.
list_user_groups
ChatGPTList all user groups for the current client.
list_users
ChatGPTList users of the current client.
list_video_compositions
ChatGPTList video editor compositions for the client (NestJS CRUD listing).
list_video_edits
ChatGPTList video editor edits (projects) for the client, optionally by source.
list_video_templates
ChatGPTList video editor templates for the client (NestJS CRUD listing).
list_youtube_broadcasts
ChatGPTList YouTube live broadcasts for a station in a datetime range.
list_youtube_cuepoints
ChatGPTList inserted YouTube ad cuepoints (audit rows) with NestJS CRUD filters.
list_youtube_playlists
ChatGPTList the YouTube playlists of a connection's channel.
promote_social_upload
ChatGPTImmediately publish a scheduled upload instead of waiting for its scheduled time.
publish_ai_social_version
ChatGPTPublish a content's social version to the target platform. This posts real content to the external social platform — verify the social version with get_ai_content before publishing.
publish_logger_fragment_social
ChatGPTPublish a fragment's primary media to a social platform (YouTube/TikTok).
query_ai_contents
ChatGPTQuery AI contents with complex filter criteria (read-only search via POST).
recut_logger_fragment
ChatGPTTrim or split an existing clip in place by keeping one or more time ranges. Unlike regenerate_logger_fragment_media (same bounds, re-export media), this replaces the fragment's chunks with ranges. Media regeneration is enqueued (audio/video re-exported, thumbnails recalculated); a completed transcription is adjusted to the new ranges. Does not clone — clone_logger_fragment first if the original must be kept.
refresh_aod_run
ChatGPTRefresh an AOD run — re-evaluates its report with current data.
refresh_youtube_playlists
ChatGPTRefresh the cached YouTube playlists for a connection from the YouTube API.
regenerate_logger_fragment_media
ChatGPTRegenerate a fragment's media assets (re-cuts audio/video from the recording).
remove_station_from_group
ChatGPTRemove a single station from a station group (reversible with add_station_to_group).
replace_logger_fragment_transcription_words
ChatGPTReplace a fragment's word-level transcription (e.g. after manual correction).
reprocess_aod_run
ChatGPTTrigger an Olaf fingerprint reprocess for an AOD run's order(s).
restart_aod_run
ChatGPTRestart a failed or stuck AOD run from scratch.
save_video_edit_state
ChatGPTSave the editor state of a video edit (e.g. autosave).
search_transcriptions
ChatGPTSearch a station's broadcast transcriptions for terms in a date range. Backed by Elasticsearch simple_query_string: '+' means AND, '|' means OR, '-' negates, quotes match an exact phrase, '*' at the end of a term matches by prefix. Returns matching transcription segments with their timestamps. Each result includes logger_url — the CloudLogger web player link to listen to that moment; use it directly instead of deriving playback URLs from segments.
search_transcriptions_advanced
ChatGPTSearch a station's broadcast transcriptions using Elasticsearch's full query_string syntax (AND/OR/NOT, wildcards, ranges). For simple queries prefer search_transcriptions (simple_query_string, more forgiving of syntax errors). Each result includes logger_url — the CloudLogger web player link to listen to that moment.
set_ai_content_user_article
ChatGPTSet the article content of an AI content after user edition.
set_station_group_stations
ChatGPTSet the complete list of stations for a group. WARNING: replaces the current membership — stations not included are removed from the group. Use add_station_to_group / remove_station_from_group for incremental changes.
set_video_edit_thumbnail
ChatGPTSet a video edit's thumbnail from a data URL.
start_fragment_social_upload
ChatGPTStart an upload of a logger fragment's media to a social platform.
start_logger_fragment_transcription
ChatGPTStart (or restart) the transcription job for a fragment.
start_report_evidence_export
ChatGPTStart an async evidence export (media package) for a persisted report. Poll get_report_export_status for progress, then fetch the download link with get_report_evidence_export_url.
start_social_upload
ChatGPTStart an upload of media to a social platform.
start_video_edit_render
ChatGPTStart rendering a video edit's project video (async).
start_video_edit_social_upload
ChatGPTStart an upload of a video-editor edit's rendered video to a social platform.
trigger_aod_manual_run
ChatGPTTrigger a manual AOD run for a rule, optionally overriding export conditions.
trigger_aod_scheduled_run
ChatGPTTrigger a manual AOD run based on an already-scheduled run, without waiting for its scheduled time.
trigger_olaf_reprocess
ChatGPTTrigger an async Olaf audio fingerprint reprocess for one or more order IDs. Enqueues a background job that calls the Olaf recognition engine to reprocess all spot matches for the given order(s). Returns a jobId that can be used to poll for completion via get_olaf_reprocess_job_status or get_olaf_reprocess_status_by_order. Possible job outcomes: - success: Olaf completed with progress=100 - no-schedules: no schedule entries found for this order - already-in-progress: a job was already running; it resumes - failed: Olaf returned an error (check failedItems)
unassign_social_connection_from_station
ChatGPTUnassign a social platform connection from a station (reversible — re-assign with assign_social_connection_to_station).
update_ai_social_version
ChatGPTUpdate a content's social version before publishing.
update_aod_rule
ChatGPTUpdate an AOD rule (partial update — only the provided fields change).
update_client_settings
ChatGPTUpdate a module's settings for a client (partial patch).
update_content_ai_station_config
ChatGPTUpdate (upsert) the content-ai configuration for a station.
update_delivery_station_config
ChatGPTUpdate (upsert) the fragments-delivery configuration for a station.
update_report_definition
ChatGPTUpdate a report definition.
update_social_connection
ChatGPTUpdate a connection: display name, station assignments and/or platform settings.
update_social_connection_settings
ChatGPTUpdate the settings of a social platform connection.
update_station
ChatGPTUpdate a station's name, language and/or timezone. Only the provided fields change.
update_station_settings
ChatGPTUpdate a module's settings for a station (partial patch).
update_user
ChatGPTUpdate a user.
update_user_group
ChatGPTUpdate a user group's name and/or membership.
update_video_composition
ChatGPTUpdate a video composition (partial update).
update_video_edit
ChatGPTUpdate a video edit's name and/or thumbnail URL (partial update).
update_video_template
ChatGPTUpdate a video editor template (partial update).
upload_audit_support_file
ChatGPTUpload an external log file (AVG, BCR or LTX) to import its entries. Use dry_run=true to validate the file without importing.
validate_mention_schedules_csv
ChatGPTValidate a mention date schedules CSV without importing it. Run this before import_mention_schedules_csv to catch format errors. NOTE: the upload format is not documented in the audit-mentions spec — sent as multipart field 'file'. Verify with backend on first use.