Telepath REST API संदर्भ

Scope: telegram.read · सिर्फ़ पढ़ना

नाम, username या numeric ID से चैट खोजें। यह पूरे Telegram की खोज नहीं है।

Query पैरामीटर

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/chats/search?query=Example&limit=10' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN"

HTTP 200 जवाब

count और chats; खोज में query हो सकता है। चैट में chat_id, name, type, username और संग्रह कवरेज फ़ील्ड हैं। Session read में source, coverage और partial भी हैं।

{
  "count": 1,
  "chats": [
    {
      "chat_id": 123456789,
      "name": "Example contact",
      "type": "private",
      "username": null,
      "message_count": 1
    }
  ]
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.read · सिर्फ़ पढ़ना

उपलब्ध संदेश टेक्स्ट खोजें। वैकल्पिक रूप से चैट और निचली तारीख़ सीमा दें।

Query पैरामीटर

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/messages/search?query=details&limit=20' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN"

HTTP 200 जवाब

count और messages; एक चैट read में chat, खोज में query और तारीख़ फ़िल्टर में since हो सकता है। संदेश में chat_id, message_id, date, direction, text, text_source, sender और उपलब्ध मीडिया/ट्रांसक्रिप्ट मेटाडेटा हैं।

{
  "count": 1,
  "messages": [
    {
      "chat_id": 123456789,
      "message_id": 42,
      "chat_name": "Example contact",
      "date": "2026-11-05T08:00:00.000Z",
      "direction": "incoming",
      "text": "Could you send the details?",
      "text_source": "written",
      "message_type": "text"
    }
  ]
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.read · सिर्फ़ पढ़ना

चैट की सीमित संदेश विंडो पढ़ता है। read भेजने से पहले REST gateway खाते के संग्रह में चैट माँगता है।

पाथ: chat_id — अनिवार्य nonzero safe integer; चैट खाते के संग्रह में होनी चाहिए।

Query पैरामीटर

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/chats/123456789/messages?limit=20' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN"

HTTP 200 जवाब

count और messages; एक चैट read में chat, खोज में query और तारीख़ फ़िल्टर में since हो सकता है। संदेश में chat_id, message_id, date, direction, text, text_source, sender और उपलब्ध मीडिया/ट्रांसक्रिप्ट मेटाडेटा हैं।

{
  "count": 1,
  "messages": [
    {
      "chat_id": 123456789,
      "message_id": 42,
      "chat_name": "Example contact",
      "date": "2026-11-05T08:00:00.000Z",
      "direction": "incoming",
      "text": "Could you send the details?",
      "text_source": "written",
      "message_type": "text"
    }
  ]
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.write · लिखने की कार्रवाई

ज्ञात निजी Business चैट या ग्रुप में भेजें। Business में reply अनुमति और 24 घंटे के भीतर आया संदेश चाहिए; ग्रुप में बॉट भेजता है। चैनल के लिए post ऑपरेशन इस्तेमाल करें। सामान्य send में idempotency key नहीं है।

पाथ: chat_id — अनिवार्य nonzero safe integer; चैट खाते के संग्रह में होनी चाहिए।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/chats/123456789/messages' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"text":"Thanks for your message."}'

HTTP 200 जवाब

फ़ील्ड: sent, chat_id, chat_name, message_id, date और text।

{
  "sent": true,
  "chat_id": 123456789,
  "chat_name": "Example contact",
  "message_id": 43,
  "date": "2026-11-05T08:01:00.000Z",
  "text": "Thanks for your message."
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.read · सिर्फ़ पढ़ना

एक संग्रहित चैट से पाँच तक फ़ोटो लें। फ़ोटो डेटा और समाप्त होने वाले लिंक मिलते हैं; n8n ChatGPT फ़ोटो विजेट नहीं दिखाता।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/messages/photos' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":123456789,"message_ids":[42]}'

HTTP 200 जवाब

count, bytes_per_photo और photos। हर आइटम में message_id और फ़ोटो फ़ील्ड या उसकी त्रुटि है; HTTP 200 का अर्थ सभी फ़ोटो लोड होना नहीं।

{
  "count": 1,
  "bytes_per_photo": 250000,
  "photos": [
    {
      "message_id": 42,
      "data": "<base64 image bytes>",
      "mimeType": "image/jpeg",
      "bytes": 12345,
      "caption": null,
      "url": null
    }
  ]
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.read · सिर्फ़ पढ़ना

संग्रहित चैट, जुड़े चैनल सहित सूचीबद्ध करें। खाली संग्रह का अर्थ Telegram में संदेश न होना नहीं।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/chats/list' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"limit":10}'

HTTP 200 जवाब

count और chats; खोज में query हो सकता है। चैट में chat_id, name, type, username और संग्रह कवरेज फ़ील्ड हैं। Session read में source, coverage और partial भी हैं।

{
  "count": 1,
  "chats": [
    {
      "chat_id": 123456789,
      "name": "Example contact",
      "type": "private",
      "username": null,
      "message_count": 1
    }
  ]
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.read · सिर्फ़ पढ़ना

अलग चैट के हाल में सहेजे संदेश पढ़ें। Telegram कनेक्शन के बाद नया संग्रह शुरू होता है; पुराना इतिहास इंपोर्ट करना होता है।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/messages/recent' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"limit":20}'

HTTP 200 जवाब

count और messages; एक चैट read में chat, खोज में query और तारीख़ फ़िल्टर में since हो सकता है। संदेश में chat_id, message_id, date, direction, text, text_source, sender और उपलब्ध मीडिया/ट्रांसक्रिप्ट मेटाडेटा हैं।

{
  "count": 1,
  "messages": [
    {
      "chat_id": 123456789,
      "message_id": 42,
      "chat_name": "Example contact",
      "date": "2026-11-05T08:00:00.000Z",
      "direction": "incoming",
      "text": "Could you send the details?",
      "text_source": "written",
      "message_type": "text"
    }
  ]
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.read · सिर्फ़ पढ़ना

फ़ाइल मेटाडेटा, समाप्त होने वाला लिंक और समर्थित होने पर निकाला टेक्स्ट लें। सहेजे Telegram file ID के बिना इंपोर्ट फ़ाइल अनुपलब्ध हो सकती है। डाउनलोड लिंक दूसरों से साझा न करें।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/messages/file' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":123456789,"message_id":42,"include_text":true}'

HTTP 200 जवाब

filename, mimeType, bytes, message_type, caption, अस्थायी url और वैकल्पिक निकाला text। text_error, text_truncated और line ranges जाँचें; केवल टेक्स्ट एक्सपोर्ट का मीडिया अनुपलब्ध हो सकता है।

{
  "filename": "example.txt",
  "mimeType": "text/plain",
  "bytes": 7,
  "message_type": "document",
  "caption": null,
  "url": null,
  "text": "Example",
  "text_truncated": false,
  "text_error": null
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.read · सिर्फ़ पढ़ना

Telepath के मीडिया लोडर से फ़ोटो डेटा और मेटाडेटा लौटाता है। चित्र दिखाना या समझना क्लाइंट पर निर्भर है; यह image-analysis एंडपॉइंट नहीं।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/messages/photo' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":123456789,"message_id":42}'

HTTP 200 जवाब

Base64 डेटा, mimeType, bytes, caption और उपलब्ध हो तो अस्थायी url। यह चित्र लाता है, उसका विश्लेषण नहीं करता।

{
  "data": "<base64 image bytes>",
  "mimeType": "image/jpeg",
  "bytes": 12345,
  "caption": null,
  "url": null
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.write · लिखने की कार्रवाई

भेजने से पहले प्राप्तकर्ता और मीडिया की पुष्टि करें। ठीक एक स्रोत दें: सार्वजनिक HTTP(S) URL या अपने संग्रह का from_chat_id और from_message_id। निजी संदेशों में Business अनुमतियाँ लागू हैं; ग्रुप में बॉट भेजता है। अनिश्चित डिलीवरी के बाद अपने-आप पुनः प्रयास न करें।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/messages/send-media' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":123456789,"url":"https://example.com/example.pdf","as_document":true}'

HTTP 200 जवाब

sent, kind, chat_id, chat_name, message_id, filename, caption और sent_as। टाइमआउट के बाद डिलीवरी अनिश्चित हो सकती है।

{
  "sent": true,
  "kind": "document",
  "chat_id": 123456789,
  "chat_name": "Example contact",
  "message_id": 44,
  "filename": "example.pdf",
  "caption": null,
  "sent_as": "you"
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.write · लिखने की कार्रवाई

सटीक नया टेक्स्ट और प्राप्तकर्ता की पुष्टि करें। केवल योग्य outgoing संदेश बदल सकते हैं। चैनल पोस्ट के लिए अलग टूल हैं।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/messages/edit' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":123456789,"message_id":43,"text":"Updated reply."}'

HTTP 200 जवाब

edited, chat_id, message_id और नया text।

{
  "edited": true,
  "chat_id": 123456789,
  "message_id": 43,
  "text": "Updated reply."
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.write · लिखने की कार्रवाई

Telegram में Business बातचीत को दिए या सबसे नए ज्ञात संदेश तक पढ़ा हुआ चिह्नित करता है। इससे unread स्थिति बदलती है; सामान्य संग्रह read से नहीं।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/messages/mark-read' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":123456789,"message_id":42}'

HTTP 200 जवाब

फ़ील्ड: marked_read, chat_id, chat_name और up_to_message_id।

{
  "marked_read": true,
  "chat_id": 123456789,
  "chat_name": "Example contact",
  "up_to_message_id": 42
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.write · लिखने की कार्रवाई

लक्ष्य और emoji की पुष्टि करें। समर्थित ग्रुप या अधिकृत जुड़े चैनल में बॉट प्रतिक्रिया देता है; निजी Business प्रतिक्रियाएँ समर्थित नहीं। बॉट प्रतिक्रिया हटाने के लिए emoji छोड़ दें।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/messages/reaction' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":-1001234567890,"message_id":42,"emoji":"👍"}'

HTTP 200 जवाब

ग्रुप में: ok, chat_id, chat_name, message_id, reaction, removed और reacted_as। चैनल परिणाम में emoji और sent_as इस्तेमाल होते हैं।

{
  "ok": true,
  "chat_id": -1001234567890,
  "chat_name": "Example group",
  "message_id": 42,
  "reaction": "👍",
  "removed": false,
  "reacted_as": "the bot"
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.read · सिर्फ़ पढ़ना

बॉट का अलग निजी-संदेश इनबॉक्स पढ़ें। chat ID समान हो तब भी इसे निजी Business चैट से न मिलाएँ।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/bot/messages' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"limit":10}'

HTTP 200 जवाब

count, note और messages। प्रविष्टि में line=bot_dm, भेजने वाले का नाम, date, text और also_has_business_chat हैं। यह इनबॉक्स Business चैट और चैनल DM से अलग है।

{
  "count": 1,
  "messages": [
    {
      "chat_id": 123456789,
      "message_id": 42,
      "from": "Example contact",
      "date": "2026-11-05T08:00:00.000Z",
      "text": "Hello",
      "line": "bot_dm",
      "also_has_business_chat": false
    }
  ]
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.write · लिखने की कार्रवाई

इस खाते के बॉट इनबॉक्स में मौजूद व्यक्ति को बॉट की ओर से अधिकृत जवाब भेजें। मालिक की Business चैट में जवाब नहीं देता। अनिश्चित डिलीवरी को अपने-आप दोबारा न भेजें।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/bot/reply' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":123456789,"text":"Thanks for your message."}'

HTTP 200 जवाब

फ़ील्ड: ok, chat_id, sent_as और message_id।

{
  "ok": true,
  "chat_id": 123456789,
  "sent_as": "the bot",
  "message_id": 43
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.write · लिखने की कार्रवाई

इस खाते के अलग बॉट इनबॉक्स के संदेश पर बॉट की प्रतिक्रिया लगाएँ। हटाने के लिए emoji छोड़ें।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/bot/reaction' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":123456789,"message_id":42,"emoji":"👍"}'

HTTP 200 जवाब

फ़ील्ड: ok, chat_id, message_id, reaction, removed और reacted_as।

{
  "ok": true,
  "chat_id": 123456789,
  "message_id": 42,
  "reaction": "👍",
  "removed": false,
  "reacted_as": "the bot"
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.write · लिखने की कार्रवाई

तय दायरे में Telepath संग्रह के संदेश स्थायी रूप से हटाएँ, Telegram से नहीं। खाते में संग्रह हटाने की क्षमता और स्पष्ट पुष्टि चाहिए। chat_id, before या दोनों दें।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/archive/forget' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"chat_id":123456789,"confirmed":true}'

HTTP 200 जवाब

forgotten (पंक्तियों की संख्या), chat_id या null, before या null और बची कॉपियों की सूचना। संग्रह डेटा हटता है, Telegram बातचीत नहीं।

{
  "forgotten": 3,
  "chat_id": 123456789,
  "before": null,
  "note": "Removed from the archive. Telegram retains its copy."
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.read · सिर्फ़ पढ़ना

इस खाते के Notes खोजें। खाली query हाल के नोट्स लौटाती है। वैकल्पिक tag फ़िल्टर है।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/notes/search' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"query":"Follow up","limit":10}'

HTTP 200 जवाब

count और notes; खोज में query भी है। list/search में संक्षेप हैं, पूरा body, links या backlinks नहीं; उनके लिए notes/get लें।

{
  "count": 1,
  "notes": [
    {
      "id": 17,
      "title": "Follow up",
      "type": "note",
      "tags": [],
      "task_status": null,
      "reminder": null,
      "created_at": "2026-11-05T08:00:00.000Z",
      "updated_at": "2026-11-05T08:00:00.000Z"
    }
  ]
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.read · सिर्फ़ पढ़ना

लिंक और backlinks सहित नोट, टास्क, प्रोजेक्ट या व्यक्ति पढ़ें। ID या सटीक title दें।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/notes/get' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"id":17}'

HTTP 200 जवाब

नोट ऑब्जेक्ट: id, title, body, tags, type, task_status, reminder, created_at, updated_at, links और backlinks।

{
  "id": 17,
  "title": "Follow up",
  "body": "Send the requested details.",
  "tags": [],
  "type": "note",
  "task_status": null,
  "reminder": null,
  "created_at": "2026-11-05T08:00:00.000Z",
  "updated_at": "2026-11-05T08:00:00.000Z",
  "links": [],
  "backlinks": []
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.read · सिर्फ़ पढ़ना

हाल के नोट्स, टास्क और प्रोजेक्ट सूचीबद्ध करें। ज़रूरत पर tag फ़िल्टर दें।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/notes/list' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"limit":10}'

HTTP 200 जवाब

count और notes; खोज में query भी है। list/search में संक्षेप हैं, पूरा body, links या backlinks नहीं; उनके लिए notes/get लें।

{
  "count": 1,
  "notes": [
    {
      "id": 17,
      "title": "Follow up",
      "type": "note",
      "tags": [],
      "task_status": null,
      "reminder": null,
      "created_at": "2026-11-05T08:00:00.000Z",
      "updated_at": "2026-11-05T08:00:00.000Z"
    }
  ]
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.write · लिखने की कार्रवाई

उपयोगकर्ता की मंज़ूर सामग्री सहेजें। title अद्वितीय हैं; [[Title]] लिंक और tags लें। प्रकार: note, project, person, task। केवल open टास्क पर स्पष्ट मंज़ूर रिमाइंडर शेड्यूल करें। quota विफलता का अर्थ कुछ सहेजा नहीं गया। डुप्लिकेट से पहले खोजें।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/notes/create' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"title":"Follow up","body":"Send the requested details."}'

HTTP 200 जवाब

नोट ऑब्जेक्ट: id, title, body, tags, type, task_status, reminder, created_at, updated_at, links और backlinks।

{
  "id": 17,
  "title": "Follow up",
  "body": "Send the requested details.",
  "tags": [],
  "type": "note",
  "task_status": null,
  "reminder": null,
  "created_at": "2026-11-05T08:00:00.000Z",
  "updated_at": "2026-11-05T08:00:00.000Z",
  "links": [],
  "backlinks": []
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.write · लिखने की कार्रवाई

संपादन से पहले पढ़ें। नाम बदलने में ID लें; अन्यथा title मौजूदा नोट चुनता है। छोड़े फ़ील्ड रहते हैं, append body जोड़ता है, tags सभी tags बदलता है। reminder:null या टास्क पूरा करना रिमाइंडर रद्द करता है। विनाशकारी बदलाव की पुष्टि लें। append अपने-आप दोबारा न चलाएँ।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/notes/update' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"id":17,"body":"Updated details."}'

HTTP 200 जवाब

नोट ऑब्जेक्ट: id, title, body, tags, type, task_status, reminder, created_at, updated_at, links और backlinks।

{
  "id": 17,
  "title": "Follow up",
  "body": "Send the requested details.",
  "tags": [],
  "type": "note",
  "task_status": null,
  "reminder": null,
  "created_at": "2026-11-05T08:00:00.000Z",
  "updated_at": "2026-11-05T08:00:00.000Z",
  "links": [],
  "backlinks": []
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.write · लिखने की कार्रवाई

उपयोगकर्ता की पुष्टि के बाद चुना नोट स्थायी रूप से हटाएँ। उसका task reminder भी रद्द होता है। ID या सटीक title दें।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/notes/delete' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"id":17}'

HTTP 200 जवाब

फ़ील्ड: deleted, id और title।

{
  "deleted": true,
  "id": 17,
  "title": "Follow up"
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.write · लिखने की कार्रवाई

एक बार का रिमाइंडर केवल प्रमाणित खाते के मालिक को। समय, timezone और टेक्स्ट स्पष्ट करें; मंज़ूरी पर ही बनाएँ। retry में वही request_id और विवरण रखें। सीमा task reminder से साझा है। scheduled का अर्थ delivered नहीं।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/reminders/create' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"text":"Follow up","at":"2027-01-15T09:00:00Z","timezone":"Europe/London","request_id":"reminder-example-001"}'

HTTP 200 जवाब

reminder, created और quota। समान request_id दोहराने पर created=false। scheduled का अर्थ delivered नहीं।

{
  "reminder": {
    "id": "r_example_reminder",
    "kind": "standalone",
    "note_id": null,
    "at": "2027-01-15T09:00:00.000Z",
    "timezone": "Europe/London",
    "text": "Follow up",
    "status": "scheduled"
  },
  "created": true
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.read · सिर्फ़ पढ़ना

अलग और task reminder तथा डिलीवरी स्थिति सूचीबद्ध करें। बची निर्माण सीमा से स्वतंत्र उपलब्ध है। डिफ़ॉल्ट में done/cancelled बाहर हैं। uncertain का अर्थ delivered नहीं।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/reminders/list' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"limit":10,"offset":0}'

HTTP 200 जवाब

count, total, reminders, next_offset (या null) और quota। offset pagination समर्थित है।

{
  "count": 1,
  "total": 1,
  "reminders": [
    {
      "id": "r_example_reminder",
      "kind": "standalone",
      "note_id": null,
      "at": "2027-01-15T09:00:00.000Z",
      "timezone": "Europe/London",
      "text": "Follow up",
      "status": "scheduled"
    }
  ],
  "next_offset": null
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.write · लिखने की कार्रवाई

मालिक के अनुरोध पर ID से रद्द करें; जुड़ा टास्क रहता है। Notes निर्माण बंद या सीमा समाप्त होने पर भी उपलब्ध। रद्द करने से निर्माण कोटा वापस नहीं आता, भेजा संदेश वापस नहीं होता।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/reminders/cancel' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"id":"r_example_reminder"}'

HTTP 200 जवाब

reminder और cancelled। लौटाई स्थिति जाँचें; रद्द करने से पहुँचा संदेश वापस नहीं होता।

{
  "reminder": {
    "id": "r_example_reminder",
    "kind": "standalone",
    "note_id": null,
    "at": "2027-01-15T09:00:00.000Z",
    "timezone": "Europe/London",
    "text": "Follow up",
    "status": "cancelled"
  },
  "cancelled": true
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.write · लिखने की कार्रवाई

जिस जुड़े चैनल के अभी मालिक हैं, उसमें प्रकाशित करें। चैनल, टेक्स्ट, सभी मीडिया और बटन लक्ष्य दिखाकर स्पष्ट मंज़ूरी लें। टेक्स्ट, एक फ़ोटो/दस्तावेज़ या 2–10 आइटम का एल्बम समर्थित है। एल्बम में बटन नहीं, दस्तावेज़ फ़ोटो/वीडियो से नहीं मिल सकते। कैप्शन 1024 तक। Post messages अधिकार चाहिए। समान retry में request_id रखें; अनिश्चित डिलीवरी पर नया ID न लें।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/channels/posts/create' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"channel_id":-1001234567890,"request_id":"post-create-example-001","confirmed":true,"text":"Example announcement."}'

HTTP 200 जवाब

ok, channel_id, channel_title, message_id और action। एल्बम में message_ids और media_group_id भी। सफल समान request_id retry सहेजा परिणाम लौटाता है।

{
  "ok": true,
  "channel_id": -1001234567890,
  "channel_title": "Example channel",
  "message_id": 42,
  "action": "telegram_create_post"
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.write · लिखने की कार्रवाई

पहले पढ़ें, चैनल और सटीक बदलाव की पुष्टि करें। छोड़े फ़ील्ड रहते हैं; खाली buttons उन्हें हटाता है। वर्तमान स्वामित्व और Edit messages चाहिए। एक एल्बम आइटम बदलता है, पूरा नहीं। समान retry में वही request_id रखें।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/channels/posts/edit' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"channel_id":-1001234567890,"message_id":42,"request_id":"post-edit-example-001","confirmed":true,"text":"Updated announcement."}'

HTTP 200 जवाब

ok, channel_id, channel_title, message_id और action। एल्बम में message_ids और media_group_id भी। सफल समान request_id retry सहेजा परिणाम लौटाता है।

{
  "ok": true,
  "channel_id": -1001234567890,
  "channel_title": "Example channel",
  "message_id": 42,
  "action": "telegram_edit_post"
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.write · लिखने की कार्रवाई

पुष्टि के बाद एक संग्रहित पोस्ट Telegram से स्थायी रूप से हटाएँ। वर्तमान स्वामित्व, Delete messages और Telegram deletion window चाहिए। केवल संग्रह से नहीं हटता। समान retry में वही request_id रखें।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/channels/posts/delete' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"channel_id":-1001234567890,"message_id":42,"request_id":"post-delete-example-001","confirmed":true}'

HTTP 200 जवाब

ok, channel_id, channel_title, message_id और action। एल्बम में message_ids और media_group_id भी। सफल समान request_id retry सहेजा परिणाम लौटाता है।

{
  "ok": true,
  "channel_id": -1001234567890,
  "channel_title": "Example channel",
  "message_id": 42,
  "action": "telegram_delete_post"
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।

Scope: telegram.write · लिखने की कार्रवाई

चैनल, पोस्ट और इच्छित स्थिति की पुष्टि करें। केवल इसी पोस्ट को पिन/अनपिन करता है; वर्तमान स्वामित्व और Edit messages चाहिए। समान retry में वही request_id।

JSON बॉडी

अनुरोध उदाहरण

curl 'https://telepath.lemma.company/api/v1/channels/posts/pin' \
  -H "Authorization: Bearer $TELEPATH_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"channel_id":-1001234567890,"message_id":42,"request_id":"post-pin-example-001","confirmed":true,"pinned":true}'

HTTP 200 जवाब

ok, channel_id, channel_title, message_id और action। एल्बम में message_ids और media_group_id भी। सफल समान request_id retry सहेजा परिणाम लौटाता है।

{
  "ok": true,
  "channel_id": -1001234567890,
  "channel_title": "Example channel",
  "message_id": 42,
  "action": "telegram_set_post_pinned"
}

साझा त्रुटियाँ और पुनः प्रयास नियम देखें। हर ऑपरेशन में खाते की अनुमतियाँ और सुविधा उपलब्धता जाँची जाती हैं।