Skip to main content
POST
/
import
/
unclassified
Import Unclassified Data
curl --request POST \
  --url https://api.ever.day/import/unclassified \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "items": [
    {
      "entityType": "person",
      "entityId": "EMP-12345",
      "createdAt": "2025-01-15T10:30:00Z",
      "payload": {
        "reviewText": "Dylan consistently exceeds expectations on delivery and collaboration.",
        "rating": 5
      },
      "metadata": {
        "reviewerId": "MGR-999",
        "cycle": "2024-H2"
      }
    }
  ],
  "batchId": "batch-2025-01-15-001",
  "topic": "performance_review",
  "source": "workday"
}
'
{
  "message": "Message received."
}

Authorizations

x-api-key
string
header
required

Include your API key in the x-api-key header to authenticate requests. Each organisation is provided with a unique API key. If your key is lost or compromised, contact support to request a new one.

Body

application/json

Request payload for importing one or more unclassified items.

items
object[]
required

List of unclassified items to import.

Minimum array length: 1
batchId
string

Optional client-provided batch identifier to correlate imports.

Example:

"batch-2025-01-15-001"

topic
string

High-level hint for the type of data, e.g. "performance_review", "cv", "survey".

Example:

"performance_review"

source
string

External system name or identifier.

Example:

"workday"

Response

Import accepted for asynchronous processing.

Response returned after the import request has been accepted.

message
string
required

Confirmation message.

Example:

"Message received."