Dynamic POP API

Send POP events using your own flexible schema. Use this endpoint when you need to control the structure of your event data.

Endpoint

POST /coatro/v1/pop/dynamic

Description

Send POP events using your own flexible schema. You control the structure of each event object, and you specify a schema version to track changes over time.

Request Body

{
  "schemaVersion": "1.0",
  "events": [
    {
      // Your custom event structure
      "customField1": "value1",
      "customField2": 123,
      "timestamp": "2025-01-27T10:00:00Z"
    }
  ]
}

Request Schema

Field	Type	Required	Description
schemaVersion	string	Yes	Version identifier for your event schema (e.g., "1.0", "2.1")
events	array	Yes	Array of event objects with your custom structure

Example Request

curl -X POST "http://localhost:8080/coatro/v1/pop/dynamic" \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "schemaVersion": "1.0",
    "events": [
      {
        "customField1": "value1",
        "customField2": 123,
        "timestamp": "2025-01-27T10:00:00Z"
      }
    ]
  }'

Response

202 Accepted

Your events have been accepted and will be processed.

{
  "message": "Events accepted",
  "acceptedAt": "2025-01-27T10:00:00Z",
  "eventCount": 1,
  "schemaVersion": "1.0"
}

Response Schema

Field	Type	Description
message	string	Status message
acceptedAt	string	Timestamp when events were accepted
eventCount	integer	Number of events accepted
schemaVersion	string	Schema version you provided

Error Responses

• 400 Bad Request - Invalid event data or missing required fields
• 401 Unauthorized - Invalid or missing API key
• 500 Internal Server Error - Server error

Related: Dynamic Bulk Ingestion

For processing large files with dynamic POP events, see the Dynamic Bulk Ingestion API.