> ## Documentation Index > Fetch the complete documentation index at: https://docs.pubrio.com/llms.txt > Use this file to discover all available pages before exploring further. # تحديث Monitor > حدّث ضبط وقواعد اكتشاف Monitor موجود. ## OpenAPI ````yaml ar-openapi POST /monitors/update openapi: 3.0.0 info: description: >- تقدّم واجهة Pubrio API معلومات استخباراتية عن توسع السوق — إشارات في الوقت الفعلي تُعلِم عندما تدخل شركة سوقًا جديدة — إلى جانب بيانات الشركات والأشخاص التي تستند إليها. ابحث، وتحقق، وأثرِ الحسابات وجهات التواصل، واشترك في إشارات تحرك مصنَّفة ومؤرَّخة عبر أكثر من 200 سوق. version: 1.0.0 title: Pubrio OpenAPI termsOfService: https://pubrio.com/ar/terms-of-service contact: email: king.lai@pubrio.com name: King Lai url: https://pubrio.com/ar/get-in-touch license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html servers: - url: https://api.pubrio.com security: - pubrio_api_key: [] tags: - name: Profile description: معلومات ملف مساحة العمل وإحصاءات الاستخدام - name: Enrichment description: إثراء سجلات الأشخاص والشركات ببيانات B2B مفصّلة - name: Lookalike description: إيجاد شركات مشابهة لشركة معينة - name: Search description: البحث عن أشخاص وشركات ووظائف وأخبار وإعلانات بمرشحات - name: Lookup description: البحث عن معلومات مفصّلة لأشخاص وشركات ووظائف وأخبار وإعلانات وتقنيات محددة - name: LinkedIn description: البحث عن بيانات أشخاص وشركات عبر روابط ملفات LinkedIn - name: Redeem description: استبدال أرصدة لفتح بيانات تواصل الأشخاص (فردي ودفعي) - name: Channels description: إدارة قوالب قنوات التواصل (إنشاء، تحديث، حذف، سرد) - name: Monitor description: إنشاء وإدارة Monitors للبيانات بواجهات webhook، وإحصاءات، ومعالجة - name: Filters description: >- استرجاع قيم المرشحات المتاحة لمعاملات البحث (التقنيات، المواقع، القطاعات، إلخ) - name: API Keys description: سرد وفحص سجلات طلبات API وتحليلات الاستخدام لمفاتيح API - name: Insights description: رؤى إشارات مجمَّعة للشركات (الوظائف، الأخبار، الإعلانات). - name: Export description: تصدير بيانات دفعي (مقيَّد بالأرصدة). - name: Expansion description: >- معلومات استخباراتية عن توسع الشركات في السوق: الإشارات، المراحل، الأسواق، والتصدير. externalDocs: description: >- The Pubrio API is used to search, preview and enrich Contacts and Accounts. Pubrio database provides extensive B2B contacts and sales intelligence data. url: https://docs.pubrio.com paths: /monitors/update: post: tags: - Monitor summary: تحديث Monitor description: حدّث ضبط وقواعد اكتشاف Monitor موجود. operationId: monitors_update parameters: [] requestBody: required: true content: application/json: schema: type: object properties: monitor_id: type: string format: uuid description: المعرّف الفريد للـ Monitor المراد تحديثه. name: type: string description: اسم الـ Monitor. description: type: string description: وصف الـ Monitor. detection_mode: type: string description: >- كيفية اكتشاف الإشارات. يفحص `signal_first` السوق بشكل واسع؛ ويتتبع `company_first` قائمة حسابات مسمّاة ويتطلب شركة واحدة على الأقل، أو نطاقًا، أو رابط LinkedIn. **غير قابل للتغيير بعد الإنشاء** — تغييره في Monitor موجود يُعيد `40021`. أنشئ Monitor جديدًا بدلًا من ذلك. enum: - company_first - signal_first signal_types: type: array items: type: string enum: - jobs - news - advertisements - expansions description: أنواع الإشارات المراد مراقبتها. signal_filters: type: array items: type: object required: - signal_type properties: signal_type: type: string enum: - jobs - news - advertisements - expansions description: أي دفق (stream) يصفّي هذا الإدخال. filters: type: object description: >- مرشحات لهذا الدفق. تأخذ `jobs` و`news` و`advertisements` معاملات [Job Search](/ar/api-reference/endpoint/companies/job_search) و[News Search](/ar/api-reference/endpoint/companies/news_search) و[Advertisement Search](/ar/api-reference/endpoint/companies/advertisements_search). تأخذ `expansions` مفردات [Expansion Search](/ar/api-reference/endpoint/expansions/market_lookup): `froms` / `tos`، `window_days`، `stages`، `scopes`، `momentum`، `freshness`، `signal_types`، `signal_subtypes`، `signal_strengths`، `source_types`. احصل على الأسماء القياسية من [مرجع التوسع](/ar/api-reference/endpoint/expansions/types). description: إدخال واحد لكل دفق إشارة يراقبه الـ Monitor. example: - signal_type: jobs filters: locations: - US - signal_type: news filters: locations: - US - signal_type: advertisements filters: target_locations: - US - signal_type: expansions filters: tos: - US stages: - expanding - scaling signal_types: - HIRE - EXEC signal_strengths: - high - very_high company_filters: type: object description: >- مرشحات شركة عامة مطبَّقة كطبقة ثانية عبر كل أنواع الإشارات. تقبل نفس معاملات نقطة [Company Search](/ar/api-reference/endpoint/companies/search) — المواقع، عدد الموظفين، التقنيات، القطاعات، والمزيد. example: locations: - US employees: - - 501 - 1000 - - 1001 - 5000 companies: type: array items: type: string format: uuid description: >- قائمة معرّفات domain_search_id (UUID) للشركات. البديل: استخدم `domains` أو `linkedin_urls`. domains: type: array items: type: string description: قائمة نطاقات الشركات. بديل لـ `companies`. linkedin_urls: type: array items: type: string format: uri description: قائمة روابط شركات على LinkedIn. بديل لـ `companies`. is_company_enrichment: type: boolean description: ما إذا كان سيتم إثراء بيانات الشركة. is_people_enrichment: type: boolean description: ما إذا كان سيتم إثراء بيانات الأشخاص. people_enrichment_configs: type: array items: type: object description: >- مصفوفة من طبقات إثراء الأشخاص. تشغّل كل طبقة بحثًا مستقلًا عن الأشخاص. تحتوي `max_people_to_return` (1-25)، و`people_contact_types` (مصفوفة — تشير إلى أنواع بيانات تواصل [Redeem](/ar/api-reference/endpoint/redeem/people): email-work، email-personal، phone)، و`filters` (نفس معاملات نقطة [People Search](/ar/api-reference/endpoint/people/search)). example: - filters: people_locations: - US max_people_to_return: 3 people_contact_types: - email-work destination_type: type: string description: نوع وجهة التسليم. enum: - webhook - email - sequences destination_config: type: object description: >- ضبط الوجهة. لـ webhook: يتطلب `webhook_url` (نص)، و`headers` (كائن) و`body` (كائن) اختياريان. للبريد الإلكتروني: يقبل `email` (نص) أو `emails` (مصفوفة نصوص). للتسلسلات: يتطلب `sequence_identifier` (نص) بالإضافة إلى واحد على الأقل من `is_people_search_enrolled` / `is_company_contact_enrolled` مضبوطًا على true. example: webhook_url: https://your-webhook.com/endpoint headers: Authorization: Bearer token body: pipeline: my-webhook frequency_minute: type: integer description: >- وتيرة التفعيل بالدقائق. الأدنى: 0، الأقصى: 10080، الافتراضي: 0. minimum: 0 maximum: 10080 max_failure_trigger: type: integer description: >- الحد الأقصى للإخفاقات المتتالية قبل الإيقاف المؤقت. الأدنى: 1، الأقصى: 10، الافتراضي: 5. minimum: 1 maximum: 10 max_daily_trigger: type: integer description: >- الحد الأقصى للتفعيلات يوميًا. الأدنى: 0، الأقصى: 86400، الافتراضي: 500. minimum: 0 maximum: 86400 max_records_per_trigger: type: integer description: >- يتحكم في الحد الأقصى لعدد السجلات المُسلَّمة لكل تفعيل. القيم الأقل تقلل حجم الحمولة لكل تسليم، وهو موصى به لمجموعات النتائج الكبيرة أو التكاملات المحدودة المعدل. الأدنى: 1، الأقصى: 100، الافتراضي: 25. راجع [إعداد Webhooks](/ar/developer-guides/setting-up-webhooks) للإرشاد. minimum: 1 maximum: 100 notification_email: type: string format: email description: البريد الإلكتروني لإشعارات الإخفاق. max_retry_per_trigger: type: integer description: >- الحد الأقصى لإعادة المحاولات لكل تفعيل. الأدنى: 0، الأقصى: 3، الافتراضي: 1. minimum: 0 maximum: 3 retry_delay_second: type: integer description: >- التأخير بين إعادة المحاولات بالثواني. الأدنى: 1، الأقصى: 5، الافتراضي: 1. minimum: 1 maximum: 5 status: type: string enum: - draft - active - paused - inactive description: >- حالة دورة الحياة المراد ضبطها. تغيير الحالة يعيد ضبط عدّاد الإخفاق. required: - monitor_id responses: '200': description: >- استجابة ناجحة تحتوي على الـ Monitor المُحدَّث. تتضمن الاستجابة دائمًا monitor_id، وname، وdetection_mode، وdestination_type، وstatus، وmasked_signature، وlast_modified، بالإضافة إلى أي أعمدة أخرى كانت جزءًا من التحديث. content: application/json: schema: type: object properties: data: type: object properties: monitor_id: type: string format: uuid description: معرّف فريد للـ Monitor. name: type: string description: اسم الـ Monitor. detection_mode: type: string description: وضع الاكتشاف. destination_type: type: string description: نوع وجهة التسليم. status: type: string enum: - draft - active - paused - inactive description: حالة دورة حياة الـ Monitor. masked_signature: type: string description: توقيع webhook المُخفى. last_modified: type: string format: date-time description: الطابع الزمني لآخر تعديل على الـ Monitor. description: >- الـ Monitor المُحدَّث. تُعاد أيضًا أي أعمدة أخرى مضمَّنة في التحديث. example: data: monitor_id: b2c3d4e5-f6a7-8901-bcde-f12345678901 name: Updated Monitor Name detection_mode: company_first destination_type: webhook status: active masked_signature: 9••••••••••••••••f09 last_modified: '2026-04-05T21:00:00.000Z' '400': $ref: '#/components/responses/general_error' '429': $ref: '#/components/responses/rate_limit_error' '500': $ref: '#/components/responses/server_error' components: responses: general_error: description: >- طلب غير صحيح. كان الطلب مُصاغًا بشكل خاطئ أو يحتوي معاملات غير صالحة. تحقق من رمز الخطأ والرسالة للتفاصيل. content: application/json: schema: required: - code - message - details type: object properties: code: example: 40001 type: integer message: example: >- Errors and codes will vary depending on the scenario, please see the documentation for information. type: string details: type: object rate_limit_error: description: >- تم تجاوز حد المعدل. نُفِّذت طلبات كثيرة جدًا خلال فترة زمنية معينة. أعِد المحاولة بعد إعادة ضبط نافذة حد المعدل. content: application/json: schema: required: - error type: object properties: error: example: Request rate limit exceeded. Please wait and try again later. type: string server_error: description: >- خطأ خادم داخلي. حدث خطأ غير متوقع في الخادم. تواصل مع الدعم إن استمر الخطأ. content: application/json: schema: required: - error type: object properties: error: example: An unexpected error occurred on the server. type: string securitySchemes: pubrio_api_key: type: apiKey name: pubrio-api-key description: >- رمز API فريد يمثّل الإجراءات التي تنفّذها عبر الواجهة والصلاحيات والعمليات المقابلة. يمكنك إنشاءه عبر قسم [Settings](https://dashboard.pubrio.com/#/settings/). in: header ````