Profile

curl -X POST https://sandbox.socialos.io/v2/user \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "agent_user",
    "domain": "myapp.com",
    "address": "agent@myapp.com",
    "email": "agent@myapp.com",
    "bio": {
      "screen_name": "AI Agent",
      "avatar": "https://example.com/avatar.png"
    }
  }'

{
  "id": "usr_x7y8z9",
  "name": "agent_user",
  "domain": "myapp.com",
  "address": "agent@myapp.com",
  "created_at": "2026-02-20T10:00:00Z"
}

import requests

resp = requests.post(
    "https://sandbox.socialos.io/v2/user",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    json={
        "name": "agent_user",
        "domain": "myapp.com",
        "address": "agent@myapp.com",
        "email": "agent@myapp.com",
        "bio": {
            "screen_name": "AI Agent",
            "avatar": "https://example.com/avatar.png"
        }
    }
)
result = resp.json()
print(result)

curl https://sandbox.socialos.io/v2/identity/usr_x7y8z9/profile \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "userId": "usr_x7y8z9",
  "name": "agent_user",
  "feed": [
    {
      "type": "post",
      "text": "Hello world!",
      "timestamp": "2026-02-20T09:00:00Z"
    }
  ],
  "score": 45,
  "badges": ["early_adopter"],
  "networks": ["community-1"]
}

import requests

resp = requests.get(
    "https://sandbox.socialos.io/v2/identity/usr_x7y8z9/profile",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)
result = resp.json()
print(result)

curl "https://sandbox.socialos.io/v2/message/network/community-1?limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "network": "community-1",
  "messages": [
    {
      "id": "msg_001",
      "text": "Welcome aboard!",
      "author": "usr_x7y8z9",
      "timestamp": "2026-02-20T09:15:00Z"
    },
    {
      "id": "msg_002",
      "text": "Thanks for joining!",
      "author": "usr_a1b2c3",
      "timestamp": "2026-02-20T09:20:00Z"
    }
  ],
  "total": 2
}

import requests

resp = requests.get(
    "https://sandbox.socialos.io/v2/message/network/community-1",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"limit": 10}
)
result = resp.json()
print(result)

import requests

API_KEY = "YOUR_API_KEY"
BASE = "https://sandbox.socialos.io/v2"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}


def sync_profile(name: str, domain: str, email: str) -> dict:
    """Create or update a user profile."""
    resp = requests.post(f"{BASE}/user", headers=HEADERS, json={
        "name": name,
        "domain": domain,
        "address": email,
        "email": email,
        "bio": {"screen_name": "AI Agent", "avatar": "https://example.com/avatar.png"}
    })
    return resp.json()


def aggregate_feed(user_id: str) -> dict:
    """Fetch the unified profile with feed, score, and badges."""
    resp = requests.get(f"{BASE}/identity/{user_id}/profile", headers=HEADERS)
    return resp.json()


def track_activity(network_id: str, limit: int = 10) -> dict:
    """Retrieve recent messages from a network."""
    resp = requests.get(
        f"{BASE}/message/network/{network_id}",
        headers=HEADERS,
        params={"limit": limit}
    )
    return resp.json()


def main():
    # Step 1 - Sync the profile
    profile = sync_profile("agent_user", "myapp.com", "agent@myapp.com")
    user_id = profile["id"]
    print(f"Profile synced: {user_id} ({profile['name']})")

    # Step 2 - Aggregate the feed
    feed = aggregate_feed(user_id)
    print(f"Score: {feed['score']} | Badges: {feed['badges']}")
    for item in feed["feed"]:
        print(f"  [{item['type']}] {item['text']}")

    # Step 3 - Track network activity
    network = feed["networks"][0] if feed["networks"] else "community-1"
    activity = track_activity(network)
    print(f"Network '{network}' has {activity['total']} messages:")
    for msg in activity["messages"]:
        print(f"  {msg['author']}: {msg['text']}")


if __name__ == "__main__":
    main()