Export Soul (Phase 1)

POST

/npcs/:npcId/soul/export

Returns Arweave upload instruction and signed payload envelope.

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

npcIdstringRequired

This endpoint expects an object.

npcIdRefstringRequired

personastringRequired

npcStatemap from strings to anyRequired

Soul export phase-1 response

se1Instructionobject

se1SignedPayloadmap from strings to any

se1Signaturestring

1	curl -X POST https://api.forboc.ai/npcs/npcId/soul/export \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"npcIdRef": "npc-12345-abcde",
6	"persona": "Elder Sage of the Mystic Forest",
7	"npcState": {}
8	}'

1	{
2	"se1Instruction": {
3	"auiEndpoint": "https://arweave.net/upload",
4	"auiPayload": {},
5	"auiContentType": "application/json",
6	"auiAuthHeader": "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"
7	},
8	"se1SignedPayload": {},
9	"se1Signature": "3045022100dff9a1e3b7a4c8e2f9a1b2c3d4e5f67890123456789abcdef0123456789abcdef02207b8e9f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2d3e4f5a6b7c8d9e"
10	}