Skip to main content

​
Endpoint

POST https://theslow.net/api/slownetsite/update-site-configuration

​
Overview

This endpoint allows you to update your full SlowNet site configuration in one request. It upserts your bio, avatar URL, theme, location, mood, and manages your profile content blocks (adding, updating, deleting as needed).

​
Authentication

This endpoint requires an API key. You can retrieve an API key from your dashboard. Include it in the X-API-KEY header: 
X-API-KEY: YOUR_API_KEY_HERE
For more details, see the Authentication Guide.

​
Request Body

FieldTypeRequiredDescription
biostringoptionalYour site’s bio or description.
avatar_urlstringoptionalURL to your avatar image.
theme_idstringoptionalSelected theme ID. If blank, custom_theme will be used.
custom_themeobjectoptionalCustom theme settings (if not using a preset theme).
display_namestringoptionalYour SlowNet site display name.
locationstringoptionalLocation to display on your site.
moodstringoptionalMood emoji or string to show on your profile.
blocksarrayoptionalList of content blocks to add/update, in order by position.

​
Block object

Each block can look like: 
{
  "id": "uuid-optional",
  "type": "text",
  "content": "Welcome to my SlowNet!",
  "enabled": true
}
If id is not provided, a new UUID will be created.

​
Request Examples

​
cURL

curl -X POST   'https://theslow.net/api/slownetsite/update-site-configuration'   -H 'X-API-KEY: YOUR_API_KEY'   -H 'Content-Type: application/json'   -d '{
    "bio": "Hey there!",
    "avatar_url": "https://theslow.net/storage/avatar.png",
    "theme_id": "2",
    "location": "Calgary",
    "mood": "🌱",
    "blocks": [
      { "type": "text", "content": "Welcome!", "enabled": true }
    ]
  }'

​
Python

import requests

BASE_URL = "https://theslow.net/api"
API_KEY = "YOUR_API_KEY"

headers = {
    "X-API-KEY": API_KEY,
    "Content-Type": "application/json"
}

payload = {
    "bio": "Hey there!",
    "avatar_url": "https://theslow.net/storage/avatar.png",
    "theme_id": "2",
    "location": "Calgary",
    "mood": "🌱",
    "blocks": [
        { "type": "text", "content": "Welcome!", "enabled": True }
    ]
}

response = requests.post(
    f"{BASE_URL}/slownetsite/update-site-configuration",
    headers=headers,
    json=payload
)

if response.ok:
    print("✅ Updated:", response.json())
else:
    print("❌ Error:", response.status_code, response.json())

​
JavaScript (Fetch)

async function updateSiteConfig() {
  try {
    const response = await fetch("/api/slownetsite/update-site-configuration", {
      method: "POST",
      headers: {
        "X-API-KEY": "YOUR_API_KEY",
        "Content-Type": "application/json"
      },
      body: JSON.stringify({
        bio: "Hey there!",
        avatar_url: "https://theslow.net/storage/avatar.png",
        theme_id: "2",
        location: "Calgary",
        mood: "🌱",
        blocks: [
          { type: "text", content: "Welcome!", enabled: true }
        ]
      })
    });

    if (!response.ok) {
      const errorData = await response.json();
      console.error("Failed to update:", errorData.error);
      return;
    }

    const data = await response.json();
    console.log("Update success:", data);
  } catch (err) {
    console.error("Unexpected error:", err);
  }
}

// Example usage:
// updateSiteConfig();

​
Responses

​
200 OK

{
  "success": true
}

​
401 Unauthorized

User is not authenticated. 
{
  "error": "Unauthorized"
}

​
500 Internal Server Error

Possible errors include failing to upsert the site or manage blocks. 
{
  "error": "Failed to update site details."
}

{
  "error": "Failed to save content blocks."
}

{
  "error": "Failed to remove old content blocks."
}

​
Need Further Assistance?

If you have any questions or encounter issues, please don’t hesitate to reach out to our support team.