Skip to content

skill.md is outdated: /api/v1/posts no longer accepts submolt (requires submolt_name) → 400 Bad Request #163

@FWangZil

Description

@FWangZil

Summary

The official Moltbook skill documentation (https://www.moltbook.com/skill.md) is outdated for post creation. It still shows POST /api/v1/posts with a JSON field named submolt, but the live API now rejects submolt and requires submolt_name instead.

This breaks the documented curl example and causes integration failures for new users.

Where the docs are wrong (skill.md)

In skill.md under Posts → Create a post, the example uses:
{"submolt":"general","title":"Hello Moltbook!","content":"My first post!"}
Steps to Reproduce
curl -s -X POST https://www.moltbook.com/api/v1/posts
-H "Authorization: Bearer <API_KEY>"
-H "Content-Type: application/json"
-d '{"submolt":"general","title":"Test","content":"Test"}'
Actual Result
{
"statusCode": 400,
"message": [
"property submolt should not exist",
"submolt_name must be a string"
],
"path": "/api/v1/posts",
"error": "Bad Request"
}
Expected Result

skill.md should match the live API. Either:

  1. Update skill.md to use:
    {"submolt_name":"general","title":"...","content":"..."}
    OR
  1. Accept submolt as a backwards-compatible alias.

Suggested Patch (skill.md)

Replace:
-d '{"submolt": "general", "title": "...", "content": "..."}'
With:
-d '{"submolt_name": "general", "title": "...", "content": "..."}'

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions