{"openapi":"3.1.0","info":{"title":"Parlamento API","version":"1.0.0","description":"API de lectura para organizaciones partner. Toda operación de datos requiere un espacio de monitoreo externo autorizado."},"servers":[{"url":"https://parlamento.ai/api/v1"}],"tags":[{"name":"Identidad","description":"Identidad y capacidades efectivas del actor."},{"name":"Clientes","description":"Espacios de monitoreo externos autorizados."},{"name":"Transcripciones","description":"Búsqueda y lectura dentro de un cliente explícito."}],"security":[{"delegatedOAuth":[]},{"bearerCredential":[]}],"paths":{"/me":{"get":{"tags":["Identidad"],"operationId":"getCurrentActor","summary":"Describe el actor y sus capacidades","responses":{"200":{"description":"Actor autenticado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeResponse"}}}},"400":{"description":"Solicitud inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Autenticación ausente, inválida o vencida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Capacidad insuficiente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Límite temporal excedido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"La solicitud no se pudo auditar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/monitoring-spaces":{"get":{"tags":["Clientes"],"operationId":"listMonitoringSpaces","summary":"Lista los clientes autorizados","responses":{"200":{"description":"Espacios autorizados","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitoringSpacesResponse"}}}},"400":{"description":"Solicitud inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Autenticación ausente, inválida o vencida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Capacidad insuficiente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Límite temporal excedido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"La solicitud no se pudo auditar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/monitoring-spaces/{spaceId}":{"get":{"tags":["Clientes"],"operationId":"getMonitoringSpace","summary":"Lee un cliente autorizado","parameters":[{"$ref":"#/components/parameters/spaceId"}],"responses":{"200":{"description":"Espacio autorizado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitoringSpaceResponse"}}}},"400":{"description":"Solicitud inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Autenticación ausente, inválida o vencida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Capacidad insuficiente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"El cliente no existe dentro del alcance del actor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Límite temporal excedido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"La solicitud no se pudo auditar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/monitoring-spaces/{spaceId}/collections":{"get":{"tags":["Clientes"],"operationId":"listMonitoringCollections","summary":"Lista las fuentes seleccionadas para un cliente","description":"Devuelve la intersección entre Collections, las fuentes configuradas en el espacio y el coverage vigente de la organización.","parameters":[{"$ref":"#/components/parameters/spaceId"}],"responses":{"200":{"description":"Collections autorizadas","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MonitoringCollectionsResponse"}}}},"400":{"description":"Solicitud inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Autenticación ausente, inválida o vencida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Capacidad insuficiente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"El cliente no existe dentro del alcance del actor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Límite temporal excedido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"La solicitud no se pudo auditar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/monitoring-spaces/{spaceId}/transcripts":{"get":{"tags":["Transcripciones"],"operationId":"listTranscripts","summary":"Busca transcripciones dentro de un cliente","parameters":[{"$ref":"#/components/parameters/spaceId"},{"name":"query","in":"query","description":"Texto a buscar","schema":{"type":"string","minLength":1,"maxLength":300}},{"name":"status","in":"query","schema":{"type":"string","enum":["scheduled","in_progress","post_processing","completed","cancelled","not_available"],"default":"completed"}},{"name":"dateFrom","in":"query","schema":{"type":"string","format":"date"}},{"name":"dateTo","in":"query","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":50,"default":20}},{"name":"cursor","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Página de transcripciones autorizadas","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranscriptListResponse"}}}},"400":{"description":"Solicitud inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Autenticación ausente, inválida o vencida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Capacidad insuficiente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"El cliente no existe dentro del alcance del actor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Límite temporal excedido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"La solicitud no se pudo auditar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/monitoring-spaces/{spaceId}/transcripts/{transcriptId}":{"get":{"tags":["Transcripciones"],"operationId":"getTranscript","summary":"Lee una transcripción y audita el recurso exacto","parameters":[{"$ref":"#/components/parameters/spaceId"},{"name":"transcriptId","in":"path","required":true,"schema":{"type":"integer","minimum":1}},{"name":"maxLength","in":"query","schema":{"type":"integer","minimum":1000,"maximum":200000,"default":100000}}],"responses":{"200":{"description":"Transcripción autorizada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranscriptDetailResponse"}}}},"400":{"description":"Solicitud inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"401":{"description":"Autenticación ausente, inválida o vencida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"403":{"description":"Capacidad insuficiente","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"404":{"description":"La transcripción no existe dentro del cliente autorizado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"429":{"description":"Límite temporal excedido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"503":{"description":"La solicitud no se pudo auditar","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}}},"components":{"parameters":{"spaceId":{"name":"spaceId","in":"path","required":true,"description":"Cliente o espacio de monitoreo externo autorizado","schema":{"type":"integer","minimum":1}}},"securitySchemes":{"delegatedOAuth":{"type":"http","scheme":"bearer","bearerFormat":"pao","description":"Token breve con audiencia API obtenido por el adaptador MCP autorizado."},"bearerCredential":{"type":"http","scheme":"bearer","bearerFormat":"pv1","description":"Credencial máquina limitada a una organización, capacidades y clientes."}},"schemas":{"ApiError":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"requestId":{"type":"string","format":"uuid"},"details":{"type":"object","additionalProperties":true}}}}},"Actor":{"type":"object","required":["type","authenticationMethod","id","organizationId","isGlobalAdmin","applicationId"],"properties":{"type":{"type":"string","enum":["user","machine"]},"authenticationMethod":{"type":"string","enum":["session","oauth","api_key"]},"id":{"type":"string"},"organizationId":{"type":"integer","minimum":1},"isGlobalAdmin":{"type":"boolean"},"applicationId":{"type":["string","null"]}}},"MeResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["actor","organization","capabilities"],"properties":{"actor":{"$ref":"#/components/schemas/Actor"},"organization":{"type":"object","required":["id","name"],"properties":{"id":{"type":"integer","minimum":1},"name":{"type":"string"}}},"capabilities":{"type":"array","items":{"type":"string","enum":["profile:read","monitoring-spaces:list","monitoring-spaces:read","transcripts:list","transcripts:read"]}}}}}},"MonitoringSpace":{"type":"object","required":["id","organizationId","name","status","clientId","clientName","trialEndsAt","countries","capabilities"],"properties":{"id":{"type":"integer","minimum":1},"organizationId":{"type":"integer","minimum":1},"name":{"type":"string"},"status":{"type":"string","enum":["active","trial"]},"clientId":{"type":"integer","minimum":1},"clientName":{"type":"string"},"trialEndsAt":{"type":["string","null"],"format":"date-time"},"countries":{"type":"array","items":{"type":"string"}},"capabilities":{"type":"array","items":{"type":"string","enum":["profile:read","monitoring-spaces:list","monitoring-spaces:read","transcripts:list","transcripts:read"]}}}},"MonitoringSpaceResponse":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/MonitoringSpace"}}},"MonitoringSpacesResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["spaces"],"properties":{"spaces":{"type":"array","items":{"$ref":"#/components/schemas/MonitoringSpace"}}}}}},"MonitoringCollection":{"type":"object","required":["id","name","countryCode","kind","status","sourceIds","capabilities","resources"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"countryCode":{"type":"string"},"kind":{"type":"string","enum":["sessions","official-journal","bulletin","lobby-audiences"]},"status":{"type":"string","enum":["operational","unstable","in-development","paused","not-supported","deprecated"]},"sourceIds":{"type":"array","items":{"type":"string"}},"capabilities":{"type":"object","required":["alerts","browse","search"],"properties":{"alerts":{"type":"boolean"},"browse":{"type":"boolean"},"search":{"type":"boolean"}}},"resources":{"type":"array","items":{"type":"string","enum":["transcripts","items"]}}}},"MonitoringCollectionsResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["collections"],"properties":{"collections":{"type":"array","items":{"$ref":"#/components/schemas/MonitoringCollection"}}}}}},"TranscriptSummary":{"type":"object","required":["id","title","startTime","endTime","status","countryCode","group","subgroup","context","referenceLink","videoLink"],"properties":{"id":{"type":"integer","minimum":1},"title":{"type":"string"},"startTime":{"type":["string","null"],"format":"date-time"},"endTime":{"type":["string","null"],"format":"date-time"},"status":{"type":["string","null"],"enum":["scheduled","in_progress","post_processing","completed","cancelled","not_available",null]},"countryCode":{"type":"string"},"group":{"$ref":"#/components/schemas/NamedResource"},"subgroup":{"$ref":"#/components/schemas/NamedResource"},"context":{"type":["string","null"]},"referenceLink":{"type":["string","null"]},"videoLink":{"type":["string","null"]}}},"NamedResource":{"type":"object","required":["id","name"],"properties":{"id":{"type":"integer","minimum":1},"name":{"type":"string"}}},"TranscriptListResponse":{"type":"object","required":["data"],"properties":{"data":{"type":"object","required":["items","nextCursor"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/TranscriptSummary"}},"nextCursor":{"type":["string","null"]}}}}},"TranscriptDetail":{"allOf":[{"$ref":"#/components/schemas/TranscriptSummary"},{"type":"object","required":["transcript","truncated","chunksCount"],"properties":{"transcript":{"type":"string"},"truncated":{"type":"boolean"},"chunksCount":{"type":"integer","minimum":0}}}]},"TranscriptDetailResponse":{"type":"object","required":["data"],"properties":{"data":{"$ref":"#/components/schemas/TranscriptDetail"}}}}}}