Workspaces

A workspace represents a single website or project in AutoBlogWriter. All your blog posts, ideas, API keys, and settings belong to a workspace.

Creating a Workspace

Log in to the AutoBlogWriter Dashboard.
Click New Workspace.
Enter your website name and URL.
You'll be assigned a workspace slug (e.g., my-tech-blog) that you'll use in the SDK.

Workspace Settings

Each workspace has its own configuration:

AI Personality — Define the tone, style, and voice for AI-generated content.
Website Context — Provide background about your site so the AI generates relevant content.
API Keys — Create and manage API keys scoped to this workspace.
Webhooks — Configure revalidation endpoints for your deployed sites.
Team Members — Invite collaborators to manage content together.

Workspace Identifiers

The SDK uses two identifiers to reference a workspace:

Identifier	Format	Usage
`workspaceSlug`	`my-tech-blog`	Required for public API endpoints (what the SDK uses to fetch posts)
`workspaceId`	`ws_abc123`	Internal ID, used for authenticated dashboard endpoints

When configuring the SDK, you must provide at least one:

const client = createAutoBlogWriterClient({
  apiUrl: "https://api.autoblogwriter.app",
  apiKey: "ba_pk_...",
  workspaceSlug: "my-tech-blog", // Required for fetching posts
});

API Keys

API keys authenticate your SDK requests and are scoped to a single workspace.

Key Format

All API keys use the prefix ba_pk_ followed by a random string.

Managing Keys

Create — Dashboard > Settings > API Keys > Create New Key
Revoke — Immediately invalidates a key. Existing requests using it will fail.
Delete — Permanently removes the key record.

Security Best Practices

Store keys in environment variables, never in client-side code.
Use different keys for development and production.
Rotate keys periodically.
Revoke compromised keys immediately.

Next Steps

Blog Generation — How AI content generation works.
Client Reference — Configure the SDK client for your workspace.