> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/roboflow/roboflow-hi/deploy/vision-events/send-events.md).

# इवेंट्स भेजें

## इवेंट्स भेजें

आप Vision Events को Workflow block, REST API, या edge device backup का उपयोग करके भेज सकते हैं।

* [Workflow Block](#workflow-block) - Workflows उपयोगकर्ताओं को संभवतः आधिकारिक Roboflow block का उपयोग करना सबसे आसान लगेगा
* [REST API](#rest-api) - जो उपयोगकर्ता models को Workflows के बाहर deploy करना चुनते हैं, वे हमारी REST API का उपयोग कर सकते हैं
* [Edge Device Backup](#edge-device-backup) - Roboflow Edge devices deploy करने वाले उपयोगकर्ताओं के लिए device पर local event store से automated backup configure करना सबसे सुविधाजनक होगा

### Workflow Block

अधिकांश उपयोगकर्ताओं के लिए अनुशंसित तरीका। जोड़ें **Vision Event** block को किसी भी Roboflow Workflow में जोड़ें ताकि inference results से बिना कोड के automatically events बनाए जा सकें।

{% hint style="info" %}
यह [Roboflow Agent](/roboflow/roboflow-hi/agents/roboflow-agent.md) इसे आपके लिए सेट अप कर सकता है। जब आप Agent से ऐसा Workflow बनाने को कहते हैं जो एक model चलाता हो, तो यह automatically एक Vision Events block जोड़ देता है और उसे सही [Use Case](/roboflow/roboflow-hi/deploy/vision-events/use-cases.md).
{% endhint %}

#### सेटअप

{% stepper %}
{% step %}
**Workflow Editor खोलें**

पर जाएँ **Workflows** अपने workspace में और उस workflow को खोलें जिसमें आप events जोड़ना चाहते हैं।
{% endstep %}

{% step %}
**Vision Event Block जोड़ें**

block catalog में "Vision Event" खोजें और इसे अपने workflow में जोड़ें।
{% endstep %}

{% step %}
**Inputs connect करें**

image input और model prediction outputs को Vision Event block से connect करें।
{% endstep %}

{% step %}
**Use Case configure करें**

Use Case नाम सेट करें (`useCaseId`)। आप upstream blocks से custom metadata को भी map कर सकते हैं। एक Use Case चुनने के बाद, dropdown के नीचे "Open in Vision Events" पर क्लिक करें ताकि नए tab में उस Use Case के events page पर जा सकें।
{% endstep %}

{% step %}
**Workflow deploy करें**

अपने workflow को deploy या update करें। हर बार जब workflow चलता है, events automatically बनाए जाते हैं।
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Workflow block image upload और event creation को एक ही step में संभालता है।
{% endhint %}

### REST API

Workflows का उपयोग न करने वाले custom integrations या pipelines के लिए, आप events सीधे REST API के माध्यम से भेज सकते हैं। complete request और response schemas के लिए देखें [Vision Events API Reference](https://docs.roboflow.com/developer/rest-api/vision-events).

#### प्रमाणीकरण

सभी write endpoints के लिए ऐसी API key चाहिए जिसमें `visionEvents.write` या `device.update` scope हो। API key को Bearer token के रूप में भेजें:

```
Authorization: Bearer YOUR_API_KEY
```

#### एंड-टू-एंड उदाहरण: इमेज अपलोड करें + Event बनाएं

{% hint style="warning" %}
events भेजने से पहले आपको एक Use Case बनाना होगा। किसी `useCaseId` मौजूद न होने वाले
{% endhint %}

का संदर्भ देने वाले events अस्वीकार कर दिए जाएंगे।

**चरण 1: इमेज अपलोड करें**

```bash
curl -X POST "https://api.roboflow.com/vision-events/upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@inspection_photo.jpg"
```

**प्रतिक्रिया:**

```json
{
  "success": true,
  "sourceId": "abc123def456",
  "url": "https://storage.googleapis.com/your-workspace/abc123def456/original.jpg"
}
```

**चरण 2: अपलोड की गई इमेज का संदर्भ देकर event बनाएं**

```bash
curl -X POST "https://api.roboflow.com/vision-events" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "eventType": "quality_check",
    "useCaseId": "assembly-line-qa",
    "timestamp": "2026-03-30T14:30:00.000Z",
    "deviceId": "factory-cam-01",
    "streamId": "line-3",
    "images": [
      {
        "sourceId": "abc123def456",
        "objectDetections": [
          {
            "class": "defect",
            "x": 320,
            "y": 240,
            "width": 50,
            "height": 40,
            "confidence": 0.95
          }
        ]
      }
    ],
    "eventData": {
      "result": "fail"
    },
    "customMetadata": {
      "line_id": "line-3",
      "shift": "morning",
      "part_number": "PN-4421"
    }
  }'
```

**प्रतिक्रिया:**

```json
{
  "eventId": "evt-789ghi",
  "created": true
}
```

#### बैच में इवेंट्स बनाएं

batch endpoint का उपयोग करके एक ही request में अधिकतम 100 events भेजें:

```bash
curl -X POST "https://api.roboflow.com/vision-events/batch" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "events": [
      {
        "eventType": "quality_check",
        "useCaseId": "alksjdflaalsf32",
        "eventData": { "result": "pass" },
        "customMetadata": { "line_id": "line-1" }
      },
      {
        "eventType": "quality_check",
        "useCaseId": "alksjdflaalsf32",
        "eventData": { "result": "fail" },
        "customMetadata": { "line_id": "line-2" }
      }
    ]
  }'
```

{% hint style="info" %}
प्रति batch request अधिकतम 100 events।
{% endhint %}

### Edge Device Backup

ऐसे enterprise deployments के लिए जहाँ connectivity कभी-कभी बाधित हो सकती है, edge device events को स्थानीय रूप से संग्रहीत करता है और connectivity बहाल होने पर उन्हें Roboflow से sync करता है।

{% hint style="info" %}
Edge Device Backup के लिए Deployment Manager आवश्यक है। देखें [Deployment Manager documentation](/roboflow/roboflow-hi/deploy/device-manager.md) setup instructions के लिए।
{% endhint %}

Vision Events backup सक्षम करने के लिए:

1. Open **Deployment Manager** अपने workspace में
2. कॉन्फ़िगर करने के लिए device चुनें
3. Enable **Vision Events Backup** device के Event Store configuration में
4. Events device पर local event store में लिखे जाते हैं
5. जब device फिर से connect होता है, events automatically Roboflow से sync हो जाते हैं

sync पूरा होने के बाद events Vision Events dashboard में दिखाई देते हैं।

<figure><img src="/files/60a59deb174e50eec0122fccf8f048cc4e4c62b7" alt="" width="375"><figcaption></figcaption></figure>

#### डिवाइस पर Event डेटा

on-device Event Store ऐसी data रख सकता है जो device पर ही रहती है और कभी Roboflow पर upload नहीं होती। यह edge deployments के लिए उपयुक्त है जो बड़े या संवेदनशील artifacts को local रखते हैं, जबकि core event record का backup भी बनाए रखते हैं।

* Per-image metadata: किसी individual image से जुड़ा एक छोटा key/value object (उदा: pass/fail verdict, serial number, angle label)। यह device पर संग्रहीत रहता है और on-device Event Store API द्वारा वापस किया जाता है, लेकिन इसे query नहीं किया जा सकता और cloud में इसका backup नहीं होता।
* केवल local file attachments: किसी event से जुड़े arbitrary files (उदा: inspection blobs, thumbnails, JSON)। ये केवल device पर संग्रहीत रहते हैं और कभी upload नहीं होते, जबकि प्रति-file size cap configure की जा सकती है (default 100 MB)। कोई file केवल तब attach की जा सकती है जब event draft हो, इसलिए event को draft के रूप में बनाएं, file attach करें, फिर उसे finalize करें।

आप इस data को device के Event Store REST API के माध्यम से write और read करते हैं। endpoints और validation limits के लिए Device Manager में किसी device के "Configuration" tab से Event Store help खोलें।