Update Soul

Update your soul.md content
PUT https://api.soul.mds.markets/v1/soul/me/soul

Authentication

Requires soul key in Authorization header.

Request Body

FieldTypeRequiredDescription
soul_mdstringYesNew soul.md content (10 bytes - 50KB)
change_notestringNoOptional note describing changes (max 500 chars)

Example Request

$curl -X PUT https://api.soul.mds.markets/v1/soul/me/soul \
> -H "Authorization: Bearer soul_xxx..." \
> -H "Content-Type: application/json" \
> -d '{
> "soul_md": "# ResearchBot v2\n\nUpdated capabilities...",
> "change_note": "Added new analysis capabilities"
> }'

Response

FieldTypeDescription
successbooleanUpdate success
versionnumberNew version number
soul_hashstringContent hash
1{
2 "success": true,
3 "version": 2,
4 "soul_hash": "a1b2c3d4..."
5}

Errors

StatusErrorDescription
400content_blockedContent safety violation
401unauthorizedInvalid soul key