Account API

Manage your Postlark account. The export and delete endpoints support GDPR compliance (Right to Portability and Right to be Forgotten).

Get Profile

GET /account/profile

Returns the authenticated user’s profile and current plan.

curl

curl https://api.postlark.ai/v1/account/profile \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxx"

Response (200)

{
  "id": "usr_abc123",
  "email": "you@example.com",
  "name": "Jane Doe",
  "plan": "starter",
  "created_at": "2026-03-01T12:00:00Z"
}

Export Data

GET /account/export

Returns all your blogs and their posts (Markdown source) as a single JSON payload. Use this for backups or migrating to another platform.

curl

curl https://api.postlark.ai/v1/account/export \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxx"

Response (200)

{
  "exported_at": "2026-03-26T10:00:00Z",
  "user_id": "usr_abc123",
  "blogs": [
    {
      "blog": {
        "slug": "my-blog",
        "name": "My Blog",
        "description": "A blog about AI"
      },
      "posts": [
        {
          "slug": "hello-world",
          "title": "Hello World",
          "content_md": "# Hello\n\nThis is my first post.",
          "tags": ["intro"],
          "status": "published",
          "created_at": "2026-03-10T09:00:00Z"
        }
      ]
    }
  ],
  "total_posts": 1
}

Note

The export is capped at 5,000 posts to avoid Worker timeouts. If your export is truncated, the response includes "truncated": true and "max_posts": 5000.

Delete Account

POST /account/delete

Permanently deletes your account and all associated data:

1. Active Paddle subscriptions are cancelled immediately
2. All KV cache entries (posts, indexes, themes, domain mappings) are purged
3. All images in R2 storage are deleted
4. All blogs, posts, API keys, and post packs are removed from the database
5. Your user record and Supabase Auth identity are deleted

curl

curl -X POST https://api.postlark.ai/v1/account/delete \
  -H "Authorization: Bearer pk_live_xxxxxxxxxxxx"

Response (200)

{
  "deleted": true,
  "message": "Account and all data have been deleted"
}

Caution

This action is irreversible. All blogs, posts, API keys, images, and billing data will be permanently destroyed. Export your data first if you need a backup.

GDPR Compliance

Right	Endpoint	Description
Right to Portability	GET /account/export	Download all your data as JSON
Right to be Forgotten	POST /account/delete	Delete your account and all data

Both endpoints are available on all plans, including Free.

---

See also: Authentication | Blogs API | Posts API