{"openapi":"3.1.0","info":{"title":"Kulak REST API","version":"1.0.0","description":"Kulak sosyal dinleme API'si. Kimlik: `Authorization: Bearer kl_live_...`.\n\nZarf: başarı `{ data, meta: { requestId, idempotencyReplayed, nextCursor? } }`, hata `{ error: { code, message, requestId } }`.\n\nErişilemeyen kaynaklar 404 döner. Gövde en fazla 64 KB. Rate limit: anahtar başına dakikada 120 istek (429 + Retry-After).\n\nWebhook olayları: mention.created, mention.updated, mention.status_changed, mention.marked_irrelevant, keyword.created, keyword.updated, keyword.deleted, keyword_group.created, keyword_group.updated, keyword_group.deleted, alert.created, alert.updated, alert.deleted, alert.delivered, project.created, project.updated, project.deleted, integration.connected, integration.disconnected, webhook.test. İmza: Standard Webhooks (webhook-id, webhook-timestamp, webhook-signature)."},"servers":[{"url":"https://kulak.shippe.rs/api/v1"}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Projeler"},{"name":"Anahtar kelimeler"},{"name":"Mention'lar"},{"name":"Analiz"},{"name":"Kategoriler"},{"name":"Alarmlar"},{"name":"Kayıtlı görünümler"},{"name":"Webhook'lar"},{"name":"Hesap"}],"paths":{"/projects":{"get":{"tags":["Projeler"],"summary":"Projeleri listele","operationId":"getProjects","x-required-scope":"projects:read","description":"Gerekli kapsam: `projects:read`","parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"post":{"tags":["Projeler"],"summary":"Proje oluştur","operationId":"postProjects","x-required-scope":"projects:write","description":"Gerekli kapsam: `projects:write`","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":80},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"timezone":{"type":"string","minLength":1,"maxLength":64},"language":{"type":"string","enum":["tr","en"]}},"required":["name"]}}}},"responses":{"201":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/projects/{id}":{"get":{"tags":["Projeler"],"summary":"Proje ayrıntısı","operationId":"getProjectsId","x-required-scope":"projects:read","description":"Gerekli kapsam: `projects:read`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"patch":{"tags":["Projeler"],"summary":"Proje güncelle","operationId":"patchProjectsId","x-required-scope":"projects:write","description":"Gerekli kapsam: `projects:write`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":2,"maxLength":80},"description":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}]},"timezone":{"type":"string","minLength":1,"maxLength":64},"language":{"type":"string","enum":["tr","en"]}}}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"delete":{"tags":["Projeler"],"summary":"Proje sil","operationId":"deleteProjectsId","x-required-scope":"projects:write","description":"Gerekli kapsam: `projects:write`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/projects/{id}/members":{"get":{"tags":["Projeler"],"summary":"Üyeler ve davetler","operationId":"getProjectsIdMembers","x-required-scope":"projects:read","description":"Gerekli kapsam: `projects:read`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"post":{"tags":["Projeler"],"summary":"Üye davet et","operationId":"postProjectsIdMembers","x-required-scope":"projects:write","description":"Gerekli kapsam: `projects:write`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"role":{"default":"member","type":"string","enum":["admin","member","viewer"]}},"required":["email"]}}}},"responses":{"201":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/keywords":{"get":{"tags":["Anahtar kelimeler"],"summary":"Keyword'leri listele","operationId":"getKeywords","x-required-scope":"keywords:read","description":"Gerekli kapsam: `keywords:read`","parameters":[{"name":"projectId","in":"query","required":true,"description":"Proje kimliği (projeye kısıtlı API anahtarında opsiyonel)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"post":{"tags":["Anahtar kelimeler"],"summary":"Keyword oluştur (plan limiti uygulanır)","operationId":"postKeywords","x-required-scope":"keywords:write","description":"Gerekli kapsam: `keywords:write`","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"term":{"type":"string","minLength":2,"maxLength":120},"aliases":{"default":[],"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"excludeTerms":{"default":[],"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"matchMode":{"default":"phrase","type":"string","enum":["phrase","exact","any_word"]},"language":{"default":"tr","type":"string","enum":["tr","en","any"]},"sources":{"default":["x","reddit","youtube"],"minItems":1,"type":"array","items":{"type":"string","enum":["x","reddit","youtube","linkedin","eksi","sikayetvar","forum"]}},"type":{"default":"brand","type":"string","enum":["brand","product","competitor","person","topic"]},"groupId":{"anyOf":[{"type":"string","minLength":1,"maxLength":64},{"type":"null"}]},"active":{"default":true,"type":"boolean"},"sourceOptions":{"type":"object","properties":{"sikayetvar":{"type":"object","properties":{"brandSlug":{"type":"string","maxLength":200}},"required":["brandSlug"],"additionalProperties":false}},"additionalProperties":false},"projectId":{"type":"string","description":"Proje kimliği"}},"required":["term","projectId"]}}}},"responses":{"201":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/keywords/{id}":{"get":{"tags":["Anahtar kelimeler"],"summary":"Keyword ayrıntısı","operationId":"getKeywordsId","x-required-scope":"keywords:read","description":"Gerekli kapsam: `keywords:read`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"patch":{"tags":["Anahtar kelimeler"],"summary":"Keyword güncelle / duraklat (active)","operationId":"patchKeywordsId","x-required-scope":"keywords:write","description":"Gerekli kapsam: `keywords:write`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"term":{"type":"string","minLength":2,"maxLength":120},"aliases":{"maxItems":20,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"excludeTerms":{"maxItems":30,"type":"array","items":{"type":"string","minLength":1,"maxLength":120}},"matchMode":{"type":"string","enum":["phrase","exact","any_word"]},"language":{"type":"string","enum":["tr","en","any"]},"sources":{"minItems":1,"type":"array","items":{"type":"string","enum":["x","reddit","youtube","linkedin","eksi","sikayetvar","forum"]}},"type":{"type":"string","enum":["brand","product","competitor","person","topic"]},"groupId":{"anyOf":[{"type":"string","minLength":1,"maxLength":64},{"type":"null"}]},"active":{"type":"boolean"},"sourceOptions":{"type":"object","properties":{"sikayetvar":{"type":"object","properties":{"brandSlug":{"type":"string","maxLength":200}},"required":["brandSlug"],"additionalProperties":false}},"additionalProperties":false}}}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"delete":{"tags":["Anahtar kelimeler"],"summary":"Keyword sil","operationId":"deleteKeywordsId","x-required-scope":"keywords:write","description":"Gerekli kapsam: `keywords:write`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/keyword-groups":{"get":{"tags":["Anahtar kelimeler"],"summary":"Grupları listele","operationId":"getKeywordGroups","x-required-scope":"keywords:read","description":"Gerekli kapsam: `keywords:read`","parameters":[{"name":"projectId","in":"query","required":true,"description":"Proje kimliği (projeye kısıtlı API anahtarında opsiyonel)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"post":{"tags":["Anahtar kelimeler"],"summary":"Grup oluştur","operationId":"postKeywordGroups","x-required-scope":"keywords:write","description":"Gerekli kapsam: `keywords:write`","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60},"color":{"default":"#71717a","type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"projectId":{"type":"string","description":"Proje kimliği"}},"required":["name","projectId"]}}}},"responses":{"201":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/keyword-groups/{id}":{"get":{"tags":["Anahtar kelimeler"],"summary":"Grup ayrıntısı","operationId":"getKeywordGroupsId","x-required-scope":"keywords:read","description":"Gerekli kapsam: `keywords:read`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"patch":{"tags":["Anahtar kelimeler"],"summary":"Grup güncelle","operationId":"patchKeywordGroupsId","x-required-scope":"keywords:write","description":"Gerekli kapsam: `keywords:write`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60},"color":{"default":"#71717a","type":"string","pattern":"^#[0-9a-fA-F]{6}$"}}}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"delete":{"tags":["Anahtar kelimeler"],"summary":"Grup sil","operationId":"deleteKeywordGroupsId","x-required-scope":"keywords:write","description":"Gerekli kapsam: `keywords:write`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/mentions":{"get":{"tags":["Mention'lar"],"summary":"Mention akışı (filtreli, cursor sayfalı)","operationId":"getMentions","x-required-scope":"mentions:read","description":"Gerekli kapsam: `mentions:read`","parameters":[{"name":"projectId","in":"query","required":true,"description":"Proje kimliği (projeye kısıtlı API anahtarında opsiyonel)","schema":{"type":"string"}},{"name":"sources","in":"query","required":false,"description":"Kaynaklar","schema":{"type":"string","description":"Virgülle ayrılmış: x, reddit, youtube, linkedin, eksi, sikayetvar, forum"}},{"name":"categories","in":"query","required":false,"description":"Kategori anahtarları (virgüllü)","schema":{"type":"string"}},{"name":"sentiments","in":"query","required":false,"description":"Duygular","schema":{"type":"string","description":"Virgülle ayrılmış: olumlu, notr, olumsuz"}},{"name":"minUrgency","in":"query","required":false,"description":"En düşük aciliyet (1-5)","schema":{"type":"integer","minimum":1,"maximum":5}},{"name":"statuses","in":"query","required":false,"description":"Durumlar","schema":{"type":"string","description":"Virgülle ayrılmış: new, reviewed, actioned, archived"}},{"name":"keywordIds","in":"query","required":false,"description":"Keyword kimlikleri (virgüllü)","schema":{"type":"string"}},{"name":"groupIds","in":"query","required":false,"description":"Keyword grup kimlikleri (virgüllü)","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"Başlangıç (ISO 8601)","schema":{"type":"string","format":"date-time"}},{"name":"to","in":"query","required":false,"description":"Bitiş (ISO 8601)","schema":{"type":"string","format":"date-time"}},{"name":"datePreset","in":"query","required":false,"description":"Hazır aralık","schema":{"type":"string","enum":["today","7d","30d","this_month"]}},{"name":"q","in":"query","required":false,"description":"Metin araması (tam kelime + içerir)","schema":{"type":"string"}},{"name":"isIrrelevant","in":"query","required":false,"description":"true: yalnızca alakasızlar (varsayılan: gizli)","schema":{"type":"boolean"}},{"name":"hasFlags","in":"query","required":false,"description":"Olasılığı >= 0.5 olan bayraklar","schema":{"type":"string","description":"Virgülle ayrılmış: needsReply, isQuestion, mentionsCompetitor, purchaseIntent, isInfluencer, containsMisinformation"}},{"name":"sort","in":"query","required":false,"description":"Sıralama","schema":{"type":"string","enum":["publishedAt","urgency"]}},{"name":"cursor","in":"query","required":false,"description":"Önceki yanıttaki meta.nextCursor","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Sayfa boyutu (varsayılan 25, en fazla 100)","schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Başarılı (data dizi, meta.nextCursor)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/mentions/{id}":{"get":{"tags":["Mention'lar"],"summary":"Mention ayrıntısı (tespit özeti + notlar; maliyet/model/ham tespit içermez)","operationId":"getMentionsId","x-required-scope":"mentions:read","description":"Gerekli kapsam: `mentions:read`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"patch":{"tags":["Mention'lar"],"summary":"Durum güncelle","operationId":"patchMentionsId","x-required-scope":"mentions:write","description":"Gerekli kapsam: `mentions:write`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["new","reviewed","actioned","archived"]}},"required":["status"]}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/mentions/{id}/irrelevant":{"post":{"tags":["Mention'lar"],"summary":"Alakasız işaretle / geri al","operationId":"postMentionsIdIrrelevant","x-required-scope":"mentions:write","description":"Gerekli kapsam: `mentions:write`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"irrelevant":{"default":true,"type":"boolean"},"reason":{"type":"string","maxLength":300}}}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/analytics/mentions":{"get":{"tags":["Analiz"],"summary":"Mention analizi (zaman serisi, dağılımlar, ses payı)","operationId":"getAnalyticsMentions","x-required-scope":"mentions:read","description":"Gerekli kapsam: `mentions:read`","parameters":[{"name":"projectId","in":"query","required":true,"description":"Proje kimliği (projeye kısıtlı API anahtarında opsiyonel)","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"Başlangıç (ISO)","schema":{"type":"string","format":"date-time"}},{"name":"to","in":"query","required":false,"description":"Bitiş (ISO)","schema":{"type":"string","format":"date-time"}},{"name":"granularity","in":"query","required":false,"description":"Kova","schema":{"type":"string","enum":["hour","day","week","month"]}},{"name":"sources","in":"query","required":false,"description":"Kaynaklar","schema":{"type":"string","description":"Virgülle ayrılmış: x, reddit, youtube, linkedin, eksi, sikayetvar, forum"}},{"name":"keywordIds","in":"query","required":false,"description":"Keyword kimlikleri (virgüllü)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/categories":{"get":{"tags":["Kategoriler"],"summary":"Kategorileri listele","operationId":"getCategories","x-required-scope":"projects:read","description":"Gerekli kapsam: `projects:read`","parameters":[{"name":"projectId","in":"query","required":true,"description":"Proje kimliği (projeye kısıtlı API anahtarında opsiyonel)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"post":{"tags":["Kategoriler"],"summary":"Kategori oluştur","operationId":"postCategories","x-required-scope":"projects:write","description":"Gerekli kapsam: `projects:write`","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9]+(?:[-_][a-z0-9]+)*$"},"name":{"type":"string","minLength":1,"maxLength":60},"description":{"type":"string","minLength":10,"maxLength":600},"color":{"default":"#71717a","type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"icon":{"default":"Tag","type":"string","minLength":1,"maxLength":40,"pattern":"^[A-Za-z0-9]+$"},"active":{"default":true,"type":"boolean"},"projectId":{"type":"string","description":"Proje kimliği"}},"required":["name","description","projectId"]}}}},"responses":{"201":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/categories/{id}":{"get":{"tags":["Kategoriler"],"summary":"Kategori ayrıntısı","operationId":"getCategoriesId","x-required-scope":"projects:read","description":"Gerekli kapsam: `projects:read`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"patch":{"tags":["Kategoriler"],"summary":"Kategori güncelle","operationId":"patchCategoriesId","x-required-scope":"projects:write","description":"Gerekli kapsam: `projects:write`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60},"description":{"type":"string","minLength":10,"maxLength":600},"color":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"},"icon":{"type":"string","minLength":1,"maxLength":40,"pattern":"^[A-Za-z0-9]+$"},"active":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"delete":{"tags":["Kategoriler"],"summary":"Kategori sil (sistem kategorileri hariç)","operationId":"deleteCategoriesId","x-required-scope":"projects:write","description":"Gerekli kapsam: `projects:write`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/alerts":{"get":{"tags":["Alarmlar"],"summary":"Alarmları listele","operationId":"getAlerts","x-required-scope":"alerts:read","description":"Gerekli kapsam: `alerts:read`","parameters":[{"name":"projectId","in":"query","required":true,"description":"Proje kimliği (projeye kısıtlı API anahtarında opsiyonel)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"post":{"tags":["Alarmlar"],"summary":"Alarm oluştur","operationId":"postAlerts","x-required-scope":"alerts:write","description":"Gerekli kapsam: `alerts:write`","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"channel":{"type":"string","enum":["email","webhook"]},"targetEmails":{"default":[],"maxItems":10,"type":"array","items":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"targetWebhookId":{"anyOf":[{"type":"string","minLength":1,"maxLength":64},{"type":"null"}]},"conditions":{"default":{},"type":"object","properties":{"categories":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"minUrgency":{"type":"integer","minimum":1,"maximum":5},"sentiments":{"type":"array","items":{"type":"string","enum":["olumlu","notr","olumsuz"]}},"keywordIds":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"sources":{"type":"array","items":{"type":"string","enum":["x","reddit","youtube","linkedin","eksi","sikayetvar","forum"]}}}},"frequency":{"default":"instant","type":"string","enum":["instant","hourly","daily"]},"active":{"default":true,"type":"boolean"},"projectId":{"type":"string"}},"required":["name","channel","projectId"]}}}},"responses":{"201":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/alerts/{id}":{"get":{"tags":["Alarmlar"],"summary":"Alarm ayrıntısı","operationId":"getAlertsId","x-required-scope":"alerts:read","description":"Gerekli kapsam: `alerts:read`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"patch":{"tags":["Alarmlar"],"summary":"Alarm güncelle","operationId":"patchAlertsId","x-required-scope":"alerts:write","description":"Gerekli kapsam: `alerts:write`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":80},"channel":{"type":"string","enum":["email","webhook"]},"targetEmails":{"maxItems":10,"type":"array","items":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"targetWebhookId":{"anyOf":[{"type":"string","minLength":1,"maxLength":64},{"type":"null"}]},"conditions":{"type":"object","properties":{"categories":{"maxItems":40,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"minUrgency":{"type":"integer","minimum":1,"maximum":5},"sentiments":{"type":"array","items":{"type":"string","enum":["olumlu","notr","olumsuz"]}},"keywordIds":{"maxItems":100,"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"sources":{"type":"array","items":{"type":"string","enum":["x","reddit","youtube","linkedin","eksi","sikayetvar","forum"]}}}},"frequency":{"type":"string","enum":["instant","hourly","daily"]},"active":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"delete":{"tags":["Alarmlar"],"summary":"Alarm sil","operationId":"deleteAlertsId","x-required-scope":"alerts:write","description":"Gerekli kapsam: `alerts:write`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/saved-views":{"get":{"tags":["Kayıtlı görünümler"],"summary":"Görünümleri listele","operationId":"getSavedViews","x-required-scope":"mentions:read","description":"Gerekli kapsam: `mentions:read`","parameters":[{"name":"projectId","in":"query","required":true,"description":"Proje kimliği (projeye kısıtlı API anahtarında opsiyonel)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"post":{"tags":["Kayıtlı görünümler"],"summary":"Görünüm oluştur","operationId":"postSavedViews","x-required-scope":"mentions:write","description":"Gerekli kapsam: `mentions:write`","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60},"filters":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"string","enum":["x","reddit","youtube","linkedin","eksi","sikayetvar","forum"]}},"categories":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"sentiments":{"type":"array","items":{"type":"string","enum":["olumlu","notr","olumsuz"]}},"minUrgency":{"type":"integer","minimum":1,"maximum":5},"statuses":{"type":"array","items":{"type":"string","enum":["new","reviewed","actioned","archived"]}},"keywordIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"groupIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"dateRange":{"type":"object","properties":{"preset":{"type":"string","enum":["today","7d","30d","this_month"]},"from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"to":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}},"search":{"type":"string","maxLength":200},"isIrrelevant":{"type":"boolean"},"hasFlags":{"type":"array","items":{"type":"string","enum":["needsReply","isQuestion","mentionsCompetitor","purchaseIntent","isInfluencer","containsMisinformation"]}}}},"isShared":{"default":false,"type":"boolean"},"projectId":{"type":"string","description":"Proje kimliği"}},"required":["name","filters","projectId"]}}}},"responses":{"201":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/saved-views/{id}":{"get":{"tags":["Kayıtlı görünümler"],"summary":"Görünüm ayrıntısı","operationId":"getSavedViewsId","x-required-scope":"mentions:read","description":"Gerekli kapsam: `mentions:read`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"patch":{"tags":["Kayıtlı görünümler"],"summary":"Görünüm güncelle","operationId":"patchSavedViewsId","x-required-scope":"mentions:write","description":"Gerekli kapsam: `mentions:write`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":60},"filters":{"type":"object","properties":{"sources":{"type":"array","items":{"type":"string","enum":["x","reddit","youtube","linkedin","eksi","sikayetvar","forum"]}},"categories":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"sentiments":{"type":"array","items":{"type":"string","enum":["olumlu","notr","olumsuz"]}},"minUrgency":{"type":"integer","minimum":1,"maximum":5},"statuses":{"type":"array","items":{"type":"string","enum":["new","reviewed","actioned","archived"]}},"keywordIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"groupIds":{"type":"array","items":{"type":"string","minLength":1,"maxLength":64}},"dateRange":{"type":"object","properties":{"preset":{"type":"string","enum":["today","7d","30d","this_month"]},"from":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"},"to":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}}},"search":{"type":"string","maxLength":200},"isIrrelevant":{"type":"boolean"},"hasFlags":{"type":"array","items":{"type":"string","enum":["needsReply","isQuestion","mentionsCompetitor","purchaseIntent","isInfluencer","containsMisinformation"]}}}},"isShared":{"type":"boolean"},"sortOrder":{"type":"integer","minimum":0,"maximum":10000}}}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"delete":{"tags":["Kayıtlı görünümler"],"summary":"Görünüm sil","operationId":"deleteSavedViewsId","x-required-scope":"mentions:write","description":"Gerekli kapsam: `mentions:write`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/webhooks":{"get":{"tags":["Webhook'lar"],"summary":"Webhook'ları listele","operationId":"getWebhooks","x-required-scope":"webhooks:read","description":"Gerekli kapsam: `webhooks:read`","parameters":[{"name":"projectId","in":"query","required":true,"description":"Proje kimliği (projeye kısıtlı API anahtarında opsiyonel)","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"post":{"tags":["Webhook'lar"],"summary":"Webhook oluştur (secret yalnızca bu yanıtta)","operationId":"postWebhooks","x-required-scope":"webhooks:write","description":"Gerekli kapsam: `webhooks:write`","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","minLength":1,"maxLength":2048},"description":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"events":{"minItems":1,"type":"array","items":{"type":"string","enum":["mention.created","mention.updated","mention.status_changed","mention.marked_irrelevant","keyword.created","keyword.updated","keyword.deleted","keyword_group.created","keyword_group.updated","keyword_group.deleted","alert.created","alert.updated","alert.deleted","alert.delivered","project.created","project.updated","project.deleted","integration.connected","integration.disconnected","webhook.test"]}},"active":{"default":true,"type":"boolean"},"projectId":{"type":"string","description":"Proje kimliği"}},"required":["url","events","projectId"]}}}},"responses":{"201":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/webhooks/{id}":{"get":{"tags":["Webhook'lar"],"summary":"Webhook ayrıntısı","operationId":"getWebhooksId","x-required-scope":"webhooks:read","description":"Gerekli kapsam: `webhooks:read`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"patch":{"tags":["Webhook'lar"],"summary":"Webhook güncelle","operationId":"patchWebhooksId","x-required-scope":"webhooks:write","description":"Gerekli kapsam: `webhooks:write`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","minLength":1,"maxLength":2048},"description":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}]},"events":{"minItems":1,"type":"array","items":{"type":"string","enum":["mention.created","mention.updated","mention.status_changed","mention.marked_irrelevant","keyword.created","keyword.updated","keyword.deleted","keyword_group.created","keyword_group.updated","keyword_group.deleted","alert.created","alert.updated","alert.deleted","alert.delivered","project.created","project.updated","project.deleted","integration.connected","integration.disconnected","webhook.test"]}},"active":{"type":"boolean"}}}}}},"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}},"delete":{"tags":["Webhook'lar"],"summary":"Webhook sil","operationId":"deleteWebhooksId","x-required-scope":"webhooks:write","description":"Gerekli kapsam: `webhooks:write`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/webhooks/{id}/test":{"post":{"tags":["Webhook'lar"],"summary":"Test olayı gönder (senkron sonuç)","operationId":"postWebhooksIdTest","x-required-scope":"webhooks:write","description":"Gerekli kapsam: `webhooks:write`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/webhooks/{id}/deliveries":{"get":{"tags":["Webhook'lar"],"summary":"Teslimat geçmişi","operationId":"getWebhooksIdDeliveries","x-required-scope":"webhooks:read","description":"Gerekli kapsam: `webhooks:read`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"cursor","in":"query","required":false,"description":"Önceki yanıttaki meta.nextCursor","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Sayfa boyutu (varsayılan 25, en fazla 100)","schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Başarılı (data dizi, meta.nextCursor)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/webhooks/{id}/deliveries/{deliveryId}/replay":{"post":{"tags":["Webhook'lar"],"summary":"Teslimatı yeniden gönder","operationId":"postWebhooksIdDeliveriesDeliveryIdReplay","x-required-scope":"webhooks:write","description":"Gerekli kapsam: `webhooks:write`","parameters":[{"name":"id","in":"path","required":true,"description":"Kaynak kimliği","schema":{"type":"string"}},{"name":"deliveryId","in":"path","required":true,"description":"Teslimat kimliği","schema":{"type":"string"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Aynı anahtarla tekrarlanan istek 24 saat boyunca aynı yanıtı döner (meta.idempotencyReplayed=true).","schema":{"type":"string","maxLength":255}}],"responses":{"202":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/usage":{"get":{"tags":["Hesap"],"summary":"Plan ve kota kullanımı","operationId":"getUsage","x-required-scope":"usage:read","description":"Gerekli kapsam: `usage:read`","parameters":[{"name":"projectId","in":"query","required":false,"description":"Verilirse proje sahibinin kotası","schema":{"type":"string"}}],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}},"/account":{"get":{"tags":["Hesap"],"summary":"Hesap bilgisi","operationId":"getAccount","x-required-scope":"account:read","description":"Gerekli kapsam: `account:read`","parameters":[],"responses":{"200":{"description":"Başarılı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SuccessEnvelope"}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"403":{"$ref":"#/components/responses/Error"},"404":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"422":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API anahtarı (kl_live_...). Kapsamlar: projects:read (Projeleri okuma), projects:write (Projeleri yönetme), keywords:read (Anahtar kelimeleri okuma), keywords:write (Anahtar kelimeleri yönetme), mentions:read (Mention'ları okuma), mentions:write (Mention durumlarını güncelleme), alerts:read (Alarmları okuma), alerts:write (Alarmları yönetme), webhooks:read (Webhook'ları okuma), webhooks:write (Webhook'ları yönetme), usage:read (Kullanım ve kota bilgisi), account:read (Hesap bilgisi)"}},"schemas":{"SuccessEnvelope":{"type":"object","required":["data","meta"],"properties":{"data":{"description":"Uca göre değişen yanıt nesnesi veya dizisi"},"meta":{"type":"object","required":["requestId","idempotencyReplayed"],"properties":{"requestId":{"type":"string"},"idempotencyReplayed":{"type":"boolean"},"nextCursor":{"type":["string","null"]}}}}},"ErrorEnvelope":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["bad_request","validation_error","unauthorized","forbidden","not_found","conflict","payload_too_large","rate_limited","quota_exceeded","unavailable","internal"]},"message":{"type":"string"},"requestId":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}}}}}}}}},"responses":{"Error":{"description":"Hata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}