fluent-community

name	fluent-community
description	Use when pushing content, docs, posts, changelogs, or other updates to Fluent Community spaces through the Fluent Community REST API.

Fluent Community REST API

Push content (docs, posts, changelogs) to Fluent Community spaces on your-site.com.

Authentication

Basic Auth using credentials from ~/.env:

GA_WORDPRESS_URL = https://your-site.com
GA_USERNAME = your-username
GA_APPLICATION_PASSWORD = your-app-password

With curl: -u '$GA_USERNAME:$GA_APPLICATION_PASSWORD'

With Python urllib:

import base64
AUTH = base64.b64encode(b'your-username:your-app-password').decode()
req.add_header('Authorization', f'Basic {AUTH}')

Base URL

https://your-site.com/wp-json/fluent-community/v2

Endpoints

List Spaces

GET /spaces?per_page=50

Returns { "spaces": [ { "id", "title", "slug", "parent_id", "privacy", "status", "settings", ... } ] }

Get Space by Slug

GET /spaces/{slug}/by-slug

Returns { "space": { ... }, "permissions": { "can_create_post": true, ... } }

Join a Space

POST /spaces/{slug}/join

The authenticated user must be a member of a space to post in it.

Create a Feed/Post

POST /feeds

Parameters (form-encoded, use --data-urlencode):

• title (string) - Post title
• message (string, required) - Post content (markdown, HTML, or plain text)
• space (string, required) - Space slug (NOT space_id)
• content_type (string) - text, markdown, or html. Default: text
• privacy (string) - public or private. Default: public
• status (string) - published or draft. Default: published
• featured_image (string) - Featured image URL
• scheduled_at (datetime) - Schedule publication time

CRITICAL: Use space (slug) not space_id (numeric). Using space_id returns "Please select a valid space to post in."

curl example:

curl -s -X POST 'https://your-site.com/wp-json/fluent-community/v2/feeds' \
  -u 'your-username:your-app-password' \
  --data-urlencode 'title=My Post Title' \
  --data-urlencode 'message=Post content in markdown' \
  --data-urlencode 'content_type=markdown' \
  --data-urlencode 'space=core-forms-docs'

Python example (recommended for bulk operations):

import json, urllib.request, urllib.parse, base64

AUTH = base64.b64encode(b'your-username:your-app-password').decode()
API = 'https://your-site.com/wp-json/fluent-community/v2/feeds'

data = urllib.parse.urlencode({
    'title': 'Post Title',
    'message': content,
    'space': 'space-slug-here',
}).encode()

req = urllib.request.Request(API, data=data, method='POST')
req.add_header('Authorization', f'Basic {AUTH}')
resp = urllib.request.urlopen(req)
result = json.loads(resp.read())
feed_id = result['feed']['id']

For large content files:

curl -s -X POST "$API" \
  -u "$AUTH" \
  --data-urlencode "title=Large Doc" \
  --data-urlencode "space=space-slug" \
  --data-urlencode "message@/tmp/content.txt"

Response:

{
  "feed": {
    "id": 85,
    "title": "My Post",
    "slug": "my-post",
    "message": "...",
    "content_type": "markdown",
    "space_id": "17",
    "status": "published",
    "permalink": "https://your-site.com/circle/space/core-forms-docs/post/my-post"
  },
  "message": "Your post has been published"
}

Update a Feed/Post

POST /feeds/{feed_id}
PATCH /feeds/{feed_id}

Delete a Feed/Post

DELETE /feeds/{feed_id}

Returns { "message": "Feed has been deleted successfully" }

Create a Space

POST /spaces

Uses space[field] syntax:

curl -s -X POST "$API/spaces" \
  -u "$AUTH" \
  --data-urlencode 'space[title]=My Space' \
  --data-urlencode 'space[slug]=my-space' \
  --data-urlencode 'space[description]=Description here' \
  --data-urlencode 'space[privacy]=public'

Update a Space

PUT /spaces/{slug}/by-slug
PUT /spaces/{id}/by-id

Note: Space settings (restricted_post_only, default_post_sort_by, show_sidebar) may need to be updated via the Fluent Community admin panel rather than the API.

Known Spaces

• Core Forms (ID 8, slug: core-forms) - Discussion space
• Core Forms Docs (ID 17, slug: core-forms-docs) - Documentation
• Functionalities (ID 9, slug: functionalities) - Discussion
• Functionalities Docs (ID 18, slug: functionalities-docs) - Documentation
• GT Link Manager (ID 12, slug: gt-link-manager) - Discussion
• GT Link Manager Docs (ID 21, slug: gt-link-manager-docs) - Documentation
• GT ACF Blocks Plugin (ID 10, slug: gt-acf-blocks-plugin) - Discussion
• GT ACF Blocks Plugin Docs (ID 19, slug: gt-acf-blocks-plugin-docs) - Documentation
• GT Page Blocks Builder (ID 13, slug: gt-page-blocks-builder) - Discussion
• GT Page Blocks Builder Docs (ID 22, slug: gt-page-blocks-builder-docs) - Documentation
• GT Extensions for FluentCart (ID 11, slug: gt-extensions-for-fluentcart) - Discussion
• GT Extensions for FluentCart Docs (ID 20, slug: gt-extensions-for-fluentcart-docs) - Documentation
• Dynamic Month & Year into Posts (ID 14, slug: dynamic-month-year-into-posts) - Discussion
• Dynamic Month & Year into Posts Docs (ID 23, slug: dynamic-month-year-into-posts-docs) - Documentation
• Books (ID 15, slug: books) - Book discussions

Bulk Push Pattern

When pushing multiple markdown docs to a space:

import json, urllib.request, urllib.parse, base64, os, glob, time, re

AUTH = base64.b64encode(b'your-username:your-app-password').decode()
API = 'https://your-site.com/wp-json/fluent-community/v2/feeds'
SPACE = 'target-space-slug'
DOCS_DIR = '/path/to/docs'

# Convert markdown tables to lists (Fluent Community doesn't render tables)
table_pattern = re.compile(r'^\|[^\n]+\|\n\|[\s:|-]+\|\n(?:\|[^\n]+\|\n?)+', re.MULTILINE)

def md_table_to_list(match):
    block = match.group(0).strip()
    tlines = [l.strip() for l in block.split('\n') if l.strip()]
    headers = [h.strip() for h in tlines[0].strip('|').split('|')]
    rows = []
    for line in tlines[2:]:
        cells = [c.strip() for c in line.strip('|').split('|')]
        rows.append(cells)
    result = []
    for row in rows:
        items = []
        for i, cell in enumerate(row):
            if i < len(headers) and headers[i]:
                items.append(f"**{headers[i]}:** {cell}")
            else:
                items.append(cell)
        result.append("- " + " | ".join(items))
     .join(result)

files = (glob.glob(os.path.join(DOCS_DIR, )))

 filepath  files:
     (filepath, )  f:
        content = f.read()

    lines = content.split()
    title = lines[][:].strip()  lines[].startswith()  os.path.basename(filepath)
    content = .join(lines[:]).strip()
    content = table_pattern.sub(md_table_to_list, content)

    data = urllib.parse.urlencode({
        : title,
        : content,
        : SPACE,
    }).encode()

    req = urllib.request.Request(API, data=data, method=)
    req.add_header(, )
    resp = urllib.request.urlopen(req)
    result = json.loads(resp.read())
    ()
    time.sleep()

Gotchas

1. Use space (slug), NOT space_id - The numeric ID will silently fail with "Please select a valid space to post in."
2. Fluent Community doesn't render markdown tables - Convert tables to lists before pushing.
3. Use --data-urlencode for content with special characters, markdown, or HTML.
4. User must be a member of the space to post (join via POST /spaces/{slug}/join).
5. Rate limit - Add time.sleep(0.5) between requests when pushing in bulk.
6. Content types: text wraps in <p> tags, markdown renders markdown, html passes through raw HTML.
7. Space settings like sort order and restricted posting are best updated via the Fluent Community admin panel, not the API.

Post-Push Space Settings

After pushing docs, configure these in the Fluent Community admin panel:

• Restricted Post Only: Yes (prevents non-admin posts)
• Show Sidebar: Yes (shows post navigation)
• Disable Post Sort By: Yes (locks sort order)
• Default Post Sort By: Oldest (shows docs in chronological/chapter order)