-
Notifications
You must be signed in to change notification settings - Fork 78
Description
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:
- Update skill.md to use:
{"submolt_name":"general","title":"...","content":"..."}
OR
- Accept submolt as a backwards-compatible alias.
Suggested Patch (skill.md)
Replace:
-d '{"submolt": "general", "title": "...", "content": "..."}'
With:
-d '{"submolt_name": "general", "title": "...", "content": "..."}'