Send Events

Three ways to send Vision Events from your deployed models.

Send Events

You can send Vision Events using a Workflow block, the REST API, or edge device backup.

• Workflow Block - Workflows users will probably find it easiest to use the official Roboflow block

• REST API - Users choosing to deploy models outside of workflows can use our REST API

• Edge Device Backup - Users deploying Roboflow Edge devices will find it most convenient to configure automated backup from the local event store on device

Workflow Block

The recommended approach for most users. Add the Vision Event block to any Roboflow Workflow to automatically create events from inference results with no code needed.

Setup

1

Open the Workflow Editor

Navigate to Workflows in your workspace and open the workflow you want to add events to.

2

Add the Vision Event Block

Search for "Vision Event" in the block catalog and add it to your workflow.

3

Connect Inputs

Connect the image input and model prediction outputs to the Vision Event block.

4

Configure the Use Case

Set the Use Case name (useCaseId). You can also map custom metadata from upstream blocks.

5

Deploy the Workflow

Deploy or update your workflow. Events are created automatically each time the workflow runs.

The Workflow block handles image upload and event creation in a single step.

REST API

For custom integrations or pipelines not using Workflows, you can send events directly via the REST API.

Authentication

All write endpoints require an API key with visionEvents.write or device.update scope. Pass the API key as a Bearer token:

Authorization: Bearer YOUR_API_KEY

End-to-End Example: Upload Image + Create Event

You must create a Use Case before sending events. Events referencing a useCaseId that does not exist will be rejected.

When sending events via the API, you first upload the image, then create the event referencing the uploaded image.

Step 1: Upload the image

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

Response:

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

Step 2: Create the event, referencing the uploaded image

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"
    }
  }'

Response:

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

Batch Create Events

Send up to 100 events in a single request using the batch endpoint:

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": "assembly-line-qa",
        "eventData": { "result": "pass" },
        "customMetadata": { "line_id": "line-1" }
      },
      {
        "eventType": "quality_check",
        "useCaseId": "assembly-line-qa",
        "eventData": { "result": "fail" },
        "customMetadata": { "line_id": "line-2" }
      }
    ]
  }'

Maximum 100 events per batch request.

Edge Device Backup

For enterprise deployments where connectivity may be intermittent, the edge device stores events locally and syncs them to Roboflow when connectivity is restored.

Edge Device Backup requires Deployment Manager. See the Deployment Manager documentation for setup instructions.

To enable Vision Events backup:

1. Open Deployment Manager in your workspace

2. Select the device to configure

3. Enable Vision Events Backup in the device's Event Store configuration

4. Events are written to the local event store on the device

5. When the device reconnects, events sync to Roboflow automatically

Events appear in the Vision Events dashboard after sync completes.