Introduction

Quickstart: Data API

The Data API lets you ingest data into SafetyKit for processing and analysis. This is perfect for syncing your users, products, transactions, or any entity you want SafetyKit to understand.

Python

from safetykit import Safetykit

# Initialize the client with your API key
client = Safetykit(api_key="sk_your_api_key")

# Ingest users into the "users" namespace
response = client.data.ingest("users", {
    "data": [
        {
            "id": "user_12345",
            "email": "alice@example.com",
            "username": "alice_wonderland",
            "profile_image": "https://example.com/alice.jpg",
            "bio": "Just a curious person exploring the world!",
            "created_at": "2024-01-15T10:30:00Z"
        }
    ],
    "schema": {
        "profile_image": {"content_type": "image_url"}
    }
})

print(f"✓ Data accepted: {response.request_id}")

TypeScript

import Safetykit from "safetykit";

// Initialize the client with your API key
const client = new Safetykit({
  apiKey: "sk_your_api_key",
});

// Ingest users into the "users" namespace
const response = await client.data.ingest("users", {
  data: [
    {
      id: "user_12345",
      email: "alice@example.com",
      username: "alice_wonderland",
      profile_image: "https://example.com/alice.jpg",
      bio: "Just a curious person exploring the world!",
      created_at: "2024-01-15T10:30:00Z",
    },
  ],
  schema: {
    profile_image: { content_type: "image_url" },
  },
});

console.log(`✓ Data accepted: ${response.requestId}`);

cURL

curl -X POST https://api.safetykit.com/v1/data/users \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "data": [
      {
        "id": "user_12345",
        "email": "alice@example.com",
        "username": "alice_wonderland",
        "profile_image": "https://example.com/alice.jpg",
        "bio": "Just a curious person exploring the world!",
        "created_at": "2024-01-15T10:30:00Z"
      }
    ],
    "schema": {
      "profile_image": {"content_type": "image_url"}
    }
  }'

What happens next? SafetyKit processes your data asynchronously. You can set up webhooks to get notified when processing completes.

---

---

Install the SDK

Our SDKs handle authentication, retries, and type safety out of the box. If you prefer, you can also use the API directly.

Python

pip install safetykit

TypeScript

npm install safetykit

---

Next steps

Webhooks Get real-time notifications when processing completes.

API Reference Explore the complete API documentation.

---

Need help?

We’re here for you! Contact us at support@safetykit.com.