{"openapi":"3.1.0","jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","info":{"title":"Kallfi ACR — Third-Party API","version":"1.0.0","summary":"Surface-aware ACR account commands and retained organization operations","description":"Kallfi ACR account keys expose the canonical account Soul wizard, admitted media uploads, Post creation and generation, conversations, workflow reads, and Soul publishing and monetization. Account commands use normal product safety, quotas, account Gems, pricing and lifecycle owners before Enterprise purchase. The seven earlier organization operations retain their existing IDs, scopes, grant rules and organization economy for compatibility. Use the Account key for this request host. The canonical versioned base is https://acr.kallfi.red/v1; api.kallfi.* aliases remain compatible. Documentation and source contracts do not establish hosted deployment, Vault migration, provider readiness, funded billing, or terminal product proof. Keep bearer keys in server secret managers.","contact":{"name":"Kallfi developer documentation"}},"servers":[{"url":"https://acr.kallfi.red","description":"ACR API for this site. Versioned base: https://acr.kallfi.red/v1."}],"security":[{"bearerAuth":[]}],"tags":[{"name":"Source assets","description":"Bounded direct-upload intents for explicit appearance, content-style, and text-video-timeline source assets."},{"name":"Souls","description":"Company-scoped Soul creation, projection, and revision-checked configuration updates."},{"name":"Responses","description":"Asynchronous responses generated from bounded partner-supplied conversation context on an explicitly selected web surface."},{"name":"Generations","description":"Asynchronous image or video generation requested by product capability, an explicit web surface, and a server-priced quote."},{"name":"Operations","description":"Authoritative polling resources for accepted asynchronous work."},{"name":"Product actions","description":"Canonical account product commands, additive to the existing ACR operation catalog."},{"name":"Account product actions","description":"Normal product Soul, messaging and workflow operations using the Account wallet and canonical business owners, separate from legacy company operation IDs."}],"paths":{"/v1/soul-source-assets":{"post":{"tags":["Source assets"],"summary":"Create a source-asset upload intent","description":"Proposed operation. Records one bounded source-asset declaration and returns a short-lived direct-to-storage upload target. Kallfi validates the exact uploaded bytes asynchronously; partner application servers do not send large media through this JSON API process.","operationId":"createSoulSourceAsset","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceAssetCreateRequest"}}}},"responses":{"202":{"$ref":"#/components/responses/SourceAssetAccepted"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/PayloadTooLarge"},"415":{"$ref":"#/components/responses/UnsupportedMediaType"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-kallfi-command-scope":"workspace"}},"/v1/souls":{"post":{"tags":["Souls"],"summary":"Create a Soul","description":"Proposed operation. Creates one company-scoped Human or Creature Soul from a bounded description and an optional ordered manifest of admitted source-asset IDs. An empty manifest creates from the description alone. Source admission, safety, profile derivation, Looks, and Voice may outlive the HTTP request, so the response is an asynchronous operation.","operationId":"createSoul","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SoulCreateRequest"}}}},"responses":{"202":{"$ref":"#/components/responses/SoulAccepted"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/PayloadTooLarge"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-kallfi-command-scope":"workspace"}},"/v1/souls/{soul_id}":{"parameters":[{"$ref":"#/components/parameters/SoulId"}],"get":{"tags":["Souls"],"summary":"Read a Soul","description":"Proposed operation. Returns the company-scoped Soul projection, including its current lifecycle, immutable external identity, revision, source-asset manifest, and current capabilities. Possession of an ID is not authorization.","operationId":"getSoul","security":[{"bearerAuth":[]}],"responses":{"200":{"$ref":"#/components/responses/SoulRead"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-kallfi-command-scope":"workspace","parameters":[{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}]},"patch":{"tags":["Souls"],"summary":"Update a Soul","description":"Proposed operation. Applies allowed configuration changes only when expected_revision matches the current company-scoped revision. The description is mutable here; kind, external identity, and the accepted source manifest are not silently replaced. A successful mutation is accepted asynchronously.","operationId":"updateSoul","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/IdempotencyKey"},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SoulUpdateRequest"}}}},"responses":{"202":{"$ref":"#/components/responses/SoulUpdateAccepted"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-kallfi-command-scope":"workspace"}},"/v1/souls/{soul_id}/responses":{"post":{"tags":["Responses"],"summary":"Request a Soul response","description":"Proposed operation. Requests one response on the explicit nsfw-disabled or nsfw-enabled surface from a bounded conversation context. The server owns safety, capability, provider, model, and execution-profile selection; this endpoint does not expose raw provider or model selection. The accepted operation retains the immutable surface; reusing an idempotency key or resource identity with a different surface returns 409 with error code surface_conflict.","operationId":"createSoulResponse","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SoulId"},{"$ref":"#/components/parameters/IdempotencyKey"},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResponseCreateRequest"}}}},"responses":{"202":{"$ref":"#/components/responses/ResponseAccepted"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/PayloadTooLarge"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-kallfi-command-scope":"workspace"}},"/v1/souls/{soul_id}/generations":{"post":{"tags":["Generations"],"summary":"Request image or video generation","description":"Proposed operation. Requests one image or video operation on the explicit nsfw-disabled or nsfw-enabled surface from a server-priced quote. Clients provide a quote ID and capability request, never client-computed Gem arithmetic, provider names, or raw model names. The accepted operation retains the immutable surface; reusing an idempotency key or resource identity with a different surface returns 409 with error code surface_conflict.","operationId":"createSoulGeneration","security":[{"bearerAuth":[]}],"parameters":[{"$ref":"#/components/parameters/SoulId"},{"$ref":"#/components/parameters/IdempotencyKey"},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerationCreateRequest"}}}},"responses":{"202":{"$ref":"#/components/responses/GenerationAccepted"},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"},"413":{"$ref":"#/components/responses/PayloadTooLarge"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-kallfi-command-scope":"workspace"}},"/v1/operations/{operation_id}":{"parameters":[{"$ref":"#/components/parameters/OperationId"}],"get":{"tags":["Operations"],"summary":"Read an operation","description":"Proposed operation. Returns authoritative asynchronous state, the immutable surface for surface-owned work, usage facts, terminal failure, and output locators when available. The surface is derived from operation_id; this endpoint has no surface selector. Polling is bounded by the client's chosen cadence; completion may also be delivered through signed at-least-once webhook events.","operationId":"getOperation","security":[{"bearerAuth":[]}],"responses":{"200":{"$ref":"#/components/responses/OperationRead"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalServerError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}},"x-kallfi-command-scope":"workspace","parameters":[{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}]}},"/v1/posts":{"post":{"operationId":"createPost","tags":["Product actions"],"summary":"createPost","description":"Runs the canonical account product command. Requires a_to_z.manage; active credential scope, current issuing membership, surface grant and account eligibility are rechecked. Existing product safety, business rules, idempotency and limits remain authoritative. Uploaded Posts also require the Account’s current separate public-display upload acknowledgment through the normal Kallfi upload flow. Missing acknowledgment returns HTTP409 creator_upload_consent_required. API credentials never accept consent automatically; preserve normal age, identity, rights, safety and ownership gates.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"$ref":"#/components/schemas/ProductActionIdempotencyKey"}},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductPostRequest"}}}},"responses":{"200":{"description":"Canonical command result (including asynchronous generation acceptance where applicable).","content":{"application/json":{"schema":{"type":"object"}}}},"201":{"description":"Canonical product resource accepted."},"202":{"description":"Canonical durable product workflow accepted; terminal output must be observed separately."},"400":{"description":"Canonical validation or action ID failure."},"401":{"description":"Credential or action admission denied."},"403":{"description":"Canonical product, safety or ownership admission denied."},"409":{"description":"Canonical revision, quote, balance, quota or idempotency conflict."},"429":{"description":"Canonical bounded rate limit."},"503":{"description":"Canonical owner temporarily unavailable."}},"x-kallfi-command-scope":"account"}},"/v1/media/uploads":{"post":{"operationId":"createMediaUpload","tags":["Product actions"],"summary":"createMediaUpload","description":"Runs the canonical account product command. Requires a_to_z.manage; active credential scope, current issuing membership, surface grant and account eligibility are rechecked. Existing product safety, business rules, idempotency and limits remain authoritative.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"$ref":"#/components/schemas/ProductActionIdempotencyKey"}},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductMediaUploadRequest"}}}},"responses":{"200":{"description":"Canonical command result (including asynchronous generation acceptance where applicable).","content":{"application/json":{"schema":{"type":"object"}}}},"201":{"description":"Canonical product resource accepted."},"202":{"description":"Canonical durable product workflow accepted; terminal output must be observed separately."},"400":{"description":"Canonical validation or action ID failure."},"401":{"description":"Credential or action admission denied."},"403":{"description":"Canonical product, safety or ownership admission denied."},"409":{"description":"Canonical revision, quote, balance, quota or idempotency conflict."},"429":{"description":"Canonical bounded rate limit."},"503":{"description":"Canonical owner temporarily unavailable."}},"x-kallfi-command-scope":"account"}},"/v1/posts/generation-pricing":{"post":{"operationId":"preparePostGeneration","tags":["Product actions"],"summary":"preparePostGeneration","description":"Runs the canonical account product command. Requires generations.image.create or generations.video.create according to controls.modality; active credential scope, current issuing membership, surface grant and account eligibility are rechecked. Existing product safety, business rules, idempotency and limits remain authoritative.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"$ref":"#/components/schemas/ProductActionIdempotencyKey"}},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductGeneratePricingRequest"}}}},"responses":{"200":{"description":"Canonical command result (including asynchronous generation acceptance where applicable).","content":{"application/json":{"schema":{"type":"object"}}}},"201":{"description":"Canonical product resource accepted."},"202":{"description":"Canonical durable product workflow accepted; terminal output must be observed separately."},"400":{"description":"Canonical validation or action ID failure."},"401":{"description":"Credential or action admission denied."},"403":{"description":"Canonical product, safety or ownership admission denied."},"409":{"description":"Canonical revision, quote, balance, quota or idempotency conflict."},"429":{"description":"Canonical bounded rate limit."},"503":{"description":"Canonical owner temporarily unavailable."}},"x-kallfi-command-scope":"account"}},"/v1/posts/generations":{"post":{"operationId":"generatePost","tags":["Product actions"],"summary":"generatePost","description":"Runs the canonical account product command. Requires generations.image.create or generations.video.create according to controls.modality; active credential scope, current issuing membership, surface grant and account eligibility are rechecked. Existing product safety, business rules, idempotency and limits remain authoritative.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"$ref":"#/components/schemas/ProductActionIdempotencyKey"}},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductGenerateRequest"}}}},"responses":{"200":{"description":"Canonical command result (including asynchronous generation acceptance where applicable).","content":{"application/json":{"schema":{"type":"object"}}}},"201":{"description":"Canonical product resource accepted."},"202":{"description":"Canonical durable product workflow accepted; terminal output must be observed separately."},"400":{"description":"Canonical validation or action ID failure."},"401":{"description":"Credential or action admission denied."},"403":{"description":"Canonical product, safety or ownership admission denied."},"409":{"description":"Canonical revision, quote, balance, quota or idempotency conflict."},"429":{"description":"Canonical bounded rate limit."},"503":{"description":"Canonical owner temporarily unavailable."}},"x-kallfi-command-scope":"account"}},"/v1/souls/{soul_id}/monetize":{"post":{"operationId":"monetizeSoul","tags":["Product actions"],"summary":"monetizeSoul","description":"Runs the canonical account product command. Requires souls.update; active credential scope, current issuing membership, surface grant and account eligibility are rechecked. Existing product safety, business rules, idempotency and limits remain authoritative.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"$ref":"#/components/schemas/ProductActionIdempotencyKey"}},{"name":"soul_id","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ManagedProductSoulId"}},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSoulMonetizationRequest"}}}},"responses":{"200":{"description":"Canonical command result (including asynchronous generation acceptance where applicable).","content":{"application/json":{"schema":{"type":"object"}}}},"201":{"description":"Canonical product resource accepted."},"202":{"description":"Canonical durable product workflow accepted; terminal output must be observed separately."},"400":{"description":"Canonical validation or action ID failure."},"401":{"description":"Credential or action admission denied."},"403":{"description":"Canonical product, safety or ownership admission denied."},"409":{"description":"Canonical revision, quote, balance, quota or idempotency conflict."},"429":{"description":"Canonical bounded rate limit."},"503":{"description":"Canonical owner temporarily unavailable."}},"x-kallfi-command-scope":"account"}},"/v1/souls/{soul_id}/unmonetize":{"post":{"operationId":"unmonetizeSoul","tags":["Product actions"],"summary":"unmonetizeSoul","description":"Runs the canonical account product command. Requires souls.update; active credential scope, current issuing membership, surface grant and account eligibility are rechecked. Existing product safety, business rules, idempotency and limits remain authoritative.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"$ref":"#/components/schemas/ProductActionIdempotencyKey"}},{"name":"soul_id","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ManagedProductSoulId"}},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSoulUnmonetizationRequest"}}}},"responses":{"200":{"description":"Canonical command result (including asynchronous generation acceptance where applicable).","content":{"application/json":{"schema":{"type":"object"}}}},"201":{"description":"Canonical product resource accepted."},"202":{"description":"Canonical durable product workflow accepted; terminal output must be observed separately."},"400":{"description":"Canonical validation or action ID failure."},"401":{"description":"Credential or action admission denied."},"403":{"description":"Canonical product, safety or ownership admission denied."},"409":{"description":"Canonical revision, quote, balance, quota or idempotency conflict."},"429":{"description":"Canonical bounded rate limit."},"503":{"description":"Canonical owner temporarily unavailable."}},"x-kallfi-command-scope":"account"}},"/v1/souls/{soul_id}/publish":{"post":{"operationId":"publishSoul","tags":["Product actions"],"summary":"publishSoul","description":"Runs the canonical account product command. Requires souls.update; active credential scope, current issuing membership, surface grant and account eligibility are rechecked. Existing product safety, business rules, idempotency and limits remain authoritative.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"$ref":"#/components/schemas/ProductActionIdempotencyKey"}},{"name":"soul_id","in":"path","required":true,"schema":{"$ref":"#/components/schemas/ManagedProductSoulId"}},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductSoulPublishRequest"}}}},"responses":{"200":{"description":"Canonical command result (including asynchronous generation acceptance where applicable).","content":{"application/json":{"schema":{"type":"object"}}}},"201":{"description":"Canonical product resource accepted."},"202":{"description":"Canonical durable product workflow accepted; terminal output must be observed separately."},"400":{"description":"Canonical validation or action ID failure."},"401":{"description":"Credential or action admission denied."},"403":{"description":"Canonical product, safety or ownership admission denied."},"409":{"description":"Canonical revision, quote, balance, quota or idempotency conflict."},"429":{"description":"Canonical bounded rate limit."},"503":{"description":"Canonical owner temporarily unavailable."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/createAccountSoul":{"post":{"operationId":"createAccountSoul","tags":["Account product actions"],"summary":"createAccountSoul","description":"Normal Account product action using canonical POST command owner. Required credential scope: souls.create. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. Starts the normal paid Soul wizard, returning a draft and durable generation statuses; it is not a published Soul. Continue looks/details/languages/voice/review/promote actions exactly as the product journey. The UUID Idempotency-Key becomes the canonical setup actionId.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAccountSoulRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/getAccountSoul":{"post":{"operationId":"getAccountSoul","tags":["Account product actions"],"summary":"getAccountSoul","description":"Normal Account product action using canonical GET command owner. Required credential scope: souls.read. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAccountSoulRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/listAccountSoulDrafts":{"post":{"operationId":"listAccountSoulDrafts","tags":["Account product actions"],"summary":"listAccountSoulDrafts","description":"Normal Account product action using canonical GET command owner. Required credential scope: souls.read. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListAccountSoulDraftsRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/getAccountSoulDraft":{"post":{"operationId":"getAccountSoulDraft","tags":["Account product actions"],"summary":"getAccountSoulDraft","description":"Normal Account product action using canonical GET command owner. Required credential scope: souls.read. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAccountSoulDraftRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/updateAccountSoulDetails":{"post":{"operationId":"updateAccountSoulDetails","tags":["Account product actions"],"summary":"updateAccountSoulDetails","description":"Normal Account product action using canonical POST command owner. Required credential scope: souls.update. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAccountSoulDetailsRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/generateAccountSoulLooks":{"post":{"operationId":"generateAccountSoulLooks","tags":["Account product actions"],"summary":"generateAccountSoulLooks","description":"Normal Account product action using canonical POST command owner. Required credential scope: souls.update. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateAccountSoulLooksRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/generateAccountSoulVoice":{"post":{"operationId":"generateAccountSoulVoice","tags":["Account product actions"],"summary":"generateAccountSoulVoice","description":"Normal Account product action using canonical POST command owner. Required credential scope: souls.update. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateAccountSoulVoiceRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/selectAccountSoulVoice":{"post":{"operationId":"selectAccountSoulVoice","tags":["Account product actions"],"summary":"selectAccountSoulVoice","description":"Normal Account product action using canonical POST command owner. Required credential scope: souls.update. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SelectAccountSoulVoiceRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/updateAccountSoulLanguages":{"post":{"operationId":"updateAccountSoulLanguages","tags":["Account product actions"],"summary":"updateAccountSoulLanguages","description":"Normal Account product action using canonical POST command owner. Required credential scope: souls.update. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAccountSoulLanguagesRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/reviewAccountSoul":{"post":{"operationId":"reviewAccountSoul","tags":["Account product actions"],"summary":"reviewAccountSoul","description":"Normal Account product action using canonical POST command owner. Required credential scope: souls.update. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewAccountSoulRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/promoteAccountSoul":{"post":{"operationId":"promoteAccountSoul","tags":["Account product actions"],"summary":"promoteAccountSoul","description":"Normal Account product action using canonical POST command owner. Required credential scope: souls.update. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PromoteAccountSoulRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/getAccountSoulLore":{"post":{"operationId":"getAccountSoulLore","tags":["Account product actions"],"summary":"getAccountSoulLore","description":"Normal Account product action using canonical GET command owner. Required credential scope: souls.read. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAccountSoulLoreRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/updateAccountSoulLore":{"post":{"operationId":"updateAccountSoulLore","tags":["Account product actions"],"summary":"updateAccountSoulLore","description":"Normal Account product action using canonical POST command owner. Required credential scope: souls.update. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. Extends managed Soul Lore through canonical quota and safety admission; it does not replace the whole description.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAccountSoulLoreRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/createAccountSoulReferenceUpload":{"post":{"operationId":"createAccountSoulReferenceUpload","tags":["Account product actions"],"summary":"createAccountSoulReferenceUpload","description":"Normal Account product action using canonical POST command owner. Required credential scope: souls.create. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAccountSoulReferenceUploadRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/finalizeAccountSoulReferenceUpload":{"post":{"operationId":"finalizeAccountSoulReferenceUpload","tags":["Account product actions"],"summary":"finalizeAccountSoulReferenceUpload","description":"Normal Account product action using canonical POST command owner. Required credential scope: souls.create. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinalizeAccountSoulReferenceUploadRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/abandonAccountSoulDraft":{"post":{"operationId":"abandonAccountSoulDraft","tags":["Account product actions"],"summary":"abandonAccountSoulDraft","description":"Normal Account product action using canonical POST command owner. Required credential scope: souls.update. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AbandonAccountSoulDraftRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/deleteAccountSoulDraft":{"post":{"operationId":"deleteAccountSoulDraft","tags":["Account product actions"],"summary":"deleteAccountSoulDraft","description":"Normal Account product action using canonical POST command owner. Required credential scope: souls.update. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteAccountSoulDraftRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/prepareAccountSoulEditSeed":{"post":{"operationId":"prepareAccountSoulEditSeed","tags":["Account product actions"],"summary":"prepareAccountSoulEditSeed","description":"Normal Account product action using canonical POST command owner. Required credential scope: souls.update. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrepareAccountSoulEditSeedRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/checkAccountSoulHandle":{"post":{"operationId":"checkAccountSoulHandle","tags":["Account product actions"],"summary":"checkAccountSoulHandle","description":"Normal Account product action using canonical GET command owner. Required credential scope: souls.read. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckAccountSoulHandleRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/startAccountSoulConversation":{"post":{"operationId":"startAccountSoulConversation","tags":["Account product actions"],"summary":"startAccountSoulConversation","description":"Normal Account product action using canonical POST command owner. Required credential scope: responses.create. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartAccountSoulConversationRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/createAccountSoulResponse":{"post":{"operationId":"createAccountSoulResponse","tags":["Account product actions"],"summary":"createAccountSoulResponse","description":"Normal Account product action using canonical POST command owner. Required credential scope: responses.create. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAccountSoulResponseRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/getAccountSoulResponses":{"post":{"operationId":"getAccountSoulResponses","tags":["Account product actions"],"summary":"getAccountSoulResponses","description":"Normal Account product action using canonical GET command owner. Required credential scope: responses.create. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. ","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAccountSoulResponsesRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/getAccountOperation":{"post":{"operationId":"getAccountOperation","tags":["Account product actions"],"summary":"getAccountOperation","description":"Normal Account product action using canonical GET command owner. Required credential scope: operations.read. Active issuing membership, active grant, surface, account restrictions and product availability are checked before dispatch. Body/query cannot choose another handler, method or authenticated actor. Returns canonical workflow/output observations, never a fabricated enterprise operation ID; use the originating product scope and requestId.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAccountOperationRequest"}}}},"responses":{"200":{"description":"Unchanged canonical response, including exact draft/revision/workflow or conversation projection.","content":{"application/json":{"schema":{"type":"object"}}}},"202":{"description":"Canonical durable command acceptance; terminal output requires normal observation."},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/getAccountCreatorPlan":{"post":{"operationId":"getAccountCreatorPlan","tags":["Account product actions"],"summary":"Read Creator Plan and current Soul monetization revision","description":"Delegates canonical GET /api/creator-plan/presentation using the verified Account. Requires souls.update as a mutation prerequisite. Read response.usage.projectionRevision and pass it unchanged as expectedProjectionRevision to monetizeSoul/unmonetizeSoul; refresh after a revision conflict. The response also supplies canonical Soul action availability. No purchase or plan change occurs.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAccountCreatorPlanRequest"}}}},"responses":{"200":{"description":"Canonical CreatorPlanPresentationDto; usage.projectionRevision is the decimal-string Soul mutation revision.","content":{"application/json":{"schema":{"type":"object","properties":{"usage":{"type":"object","properties":{"projectionRevision":{"type":"string","pattern":"^[0-9]+$"}},"required":["projectionRevision"]}},"required":["usage"]}}}},"401":{"description":"Credential/scope/grant/issuer admission denied."},"403":{"description":"Account product admission denied."},"503":{"description":"Canonical presentation owner unavailable."}},"x-kallfi-command-scope":"account"}},"/v1/account/actions/listAccountConversations":{"post":{"operationId":"listAccountConversations","tags":["Account product actions"],"summary":"listAccountConversations","description":"Read bounded subject/surface-bound conversation inbox; no mark-read effect. Account Personal only; explicit Team selection is rejected without fallback. Canonical surface, current membership/restriction and entity/participant ownership checks remain authoritative.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListAccountConversationsRequest"}}}},"responses":{"200":{"description":"Canonical typed response.","content":{"application/json":{"schema":{"type":"object","properties":{"conversations":{"type":"array","maxItems":50,"items":{"type":"object","properties":{"viewer_entity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"counterparty_account_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"counterparty_entity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"recipient_entity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"actor_entity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"last_message_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"last_message_sender_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"id":{"type":"string","format":"uuid"},"participant_a_id":{"type":"string","format":"uuid"},"participant_b_id":{"type":"string","format":"uuid"},"identity_state":{"const":"exact"},"conversation_kind":{"enum":["ordinary","support"]},"web_surface":{"enum":["shared","nsfw-disabled","nsfw-enabled"]},"pair_key":{"type":"string"},"counterparty_entity_source":{"anyOf":[{"type":"string"},{"type":"null"}]},"last_message_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"last_message_preview":{"anyOf":[{"type":"string"},{"type":"null"}]},"last_message_preview_kind":{"anyOf":[{"type":"string"},{"type":"null"}]},"last_message_support_system_kind":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"unread_count":{"type":"integer","minimum":0},"last_received_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"other_user":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"entity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"username":{"anyOf":[{"type":"string"},{"type":"null"}]},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"username_last_changed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"image":{"anyOf":[{"type":"string"},{"type":"null"}]},"bio":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"username_set":{"type":"boolean"},"is_creator":{"type":"boolean"},"is_official_creator":{"type":"boolean"},"verification_mark_kind":{"anyOf":[{"type":"string"},{"type":"null"}]},"has_verification_mark":{"type":"boolean"}}},{"type":"null"}]},"other_creator":{"anyOf":[{"type":"object","properties":{"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"entity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"is_creator":{"type":"boolean"},"identity_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"enable_automated_responses_offers":{"type":"boolean"},"enable_gem_spend":{"type":"boolean"},"verification_mark_kind":{"anyOf":[{"type":"string"},{"type":"null"}]},"has_verification_mark":{"type":"boolean"}}},{"type":"null"}]},"otherUser":{"anyOf":[{"type":"object","properties":{"id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"entity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"username":{"anyOf":[{"type":"string"},{"type":"null"}]},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"username_last_changed_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"image":{"anyOf":[{"type":"string"},{"type":"null"}]},"bio":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"username_set":{"type":"boolean"},"is_creator":{"type":"boolean"},"is_official_creator":{"type":"boolean"},"verification_mark_kind":{"anyOf":[{"type":"string"},{"type":"null"}]},"has_verification_mark":{"type":"boolean"}}},{"type":"null"}]},"otherCreatorProfile":{"anyOf":[{"type":"object","properties":{"user_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"entity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"is_creator":{"type":"boolean"},"identity_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"enable_automated_responses_offers":{"type":"boolean"},"enable_gem_spend":{"type":"boolean"},"verification_mark_kind":{"anyOf":[{"type":"string"},{"type":"null"}]},"has_verification_mark":{"type":"boolean"}}},{"type":"null"}]}},"required":["id","identity_state","conversation_kind","web_surface","participant_a_id","participant_b_id","created_at","updated_at","unread_count"]}},"profile_entity_id":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"total_unread":{"type":"integer","minimum":0},"has_more":{"type":"boolean"},"next_cursor":{"anyOf":[{"type":"string","maxLength":512},{"type":"null"}]}},"required":["conversations","profile_entity_id","total_unread","has_more","next_cursor"]}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"GET","x-kallfi-read-only":true}},"/v1/account/actions/getAccountUnreadMessageCount":{"post":{"operationId":"getAccountUnreadMessageCount","tags":["Account product actions"],"summary":"getAccountUnreadMessageCount","description":"Read actual selected Personal subject unread count. Account Personal only; explicit Team selection is rejected without fallback. Canonical surface, current membership/restriction and entity/participant ownership checks remain authoritative.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAccountUnreadMessageCountRequest"}}}},"responses":{"200":{"description":"Canonical typed response.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"total_unread":{"type":"integer","minimum":0}},"required":["total_unread"]}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"GET","x-kallfi-read-only":true}},"/v1/account/actions/markAccountConversationRead":{"post":{"operationId":"markAccountConversationRead","tags":["Account product actions"],"summary":"markAccountConversationRead","description":"Advance canonical monotonic read-through boundary; stale boundary409. No durable UUID command journal is promised. Account Personal only; explicit Team selection is rejected without fallback. Canonical surface, current membership/restriction and entity/participant ownership checks remain authoritative.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarkAccountConversationReadRequest"}}}},"responses":{"200":{"description":"Canonical typed response.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"success":{"const":true},"conversationId":{"type":"string","format":"uuid"},"lastReadAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]},"readThroughMessageId":{"type":"string","format":"uuid"},"clearedUnreadCount":{"type":"integer","minimum":0,"maximum":9007199254740991}},"required":["success","conversationId","lastReadAt","readThroughMessageId","clearedUnreadCount"]}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"POST","x-kallfi-read-only":false}},"/v1/account/actions/getAccountCreatorPerformance":{"post":{"operationId":"getAccountCreatorPerformance","tags":["Account product actions"],"summary":"getAccountCreatorPerformance","description":"Read canonical selected Soul statistics with bounded cursor pagination; no offset inventory scan. Account Personal only; explicit Team selection is rejected without fallback. Canonical surface, current membership/restriction and entity/participant ownership checks remain authoritative.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAccountCreatorPerformanceRequest"}}}},"responses":{"200":{"description":"Canonical typed response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatorPerformancePayload"}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"GET","x-kallfi-read-only":true}},"/v1/account/actions/getAccountCreatorPerformanceGraph":{"post":{"operationId":"getAccountCreatorPerformanceGraph","tags":["Account product actions"],"summary":"getAccountCreatorPerformanceGraph","description":"Read one canonical aligned UTC period graph; projection unavailable remains503. Account Personal only; explicit Team selection is rejected without fallback. Canonical surface, current membership/restriction and entity/participant ownership checks remain authoritative.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAccountCreatorPerformanceGraphRequest"}}}},"responses":{"200":{"description":"Canonical typed response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatorPerformanceGraph"}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"GET","x-kallfi-read-only":true}},"/v1/account/actions/getAccountSoulSettings":{"post":{"operationId":"getAccountSoulSettings","tags":["Account product actions"],"summary":"getAccountSoulSettings","description":"Read explicit selected Soul safe settings DTO. Excludes payout/legal identity/private asset delivery and legacy RED maintenance. Account Personal only; explicit Team selection is rejected without fallback. Canonical surface, current membership/restriction and entity/participant ownership checks remain authoritative. This native GET may initialize missing owned-surface message commercial configuration. It does not debit funds or start generation, but is not guaranteed free of writes; do not automatically retry it.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAccountSoulSettingsRequest"}}}},"responses":{"200":{"description":"Canonical typed response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/accountSoulSettingsSchema"}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"GET","x-kallfi-read-only":false}},"/v1/account/actions/updateAccountSoulAutomationPreferences":{"post":{"operationId":"updateAccountSoulAutomationPreferences","tags":["Account product actions"],"summary":"updateAccountSoulAutomationPreferences","description":"Set explicit selected Soul automation preferences using existing native eligibility. Naturally convergent; no native CAS/durable replay journal or automatic retry. Account Personal only; explicit Team selection is rejected without fallback. Canonical surface, current membership/restriction and entity/participant ownership checks remain authoritative.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAccountSoulAutomationPreferencesRequest"}}}},"responses":{"200":{"description":"Canonical typed response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/accountSoulAutomationReceiptSchema"}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"PATCH","x-kallfi-read-only":false}},"/v1/account/actions/updateAccountSoulGenerationPrices":{"post":{"operationId":"updateAccountSoulGenerationPrices","tags":["Account product actions"],"summary":"updateAccountSoulGenerationPrices","description":"Prices/catalog/current ownership and commercial dependencies remain genuine native owner validation; no invented prices. Account Personal only; current actor, canonical surface and ownership remain authoritative. Explicit Team selection is rejected without fallback. No automatic mutation retry or invented replay journal.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAccountSoulGenerationPricesRequest"}}}},"responses":{"200":{"description":"Canonical typed projection; acknowledgment is not terminal workflow success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulEconomicMutationAcknowledgment"}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"502":{"description":"Native response cannot be safely projected; inspect finite outcome metadata and do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulEconomicMutationOutcomeUnknown"}}}},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"PATCH","x-kallfi-read-only":false}},"/v1/account/actions/updateAccountSoulSubscriptionPrice":{"post":{"operationId":"updateAccountSoulSubscriptionPrice","tags":["Account product actions"],"summary":"updateAccountSoulSubscriptionPrice","description":"Prices/catalog/current ownership and commercial dependencies remain genuine native owner validation; no invented prices. Account Personal only; current actor, canonical surface and ownership remain authoritative. Explicit Team selection is rejected without fallback. No automatic mutation retry or invented replay journal.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAccountSoulSubscriptionPriceRequest"}}}},"responses":{"200":{"description":"Canonical typed projection; acknowledgment is not terminal workflow success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulEconomicMutationAcknowledgment"}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"502":{"description":"Native response cannot be safely projected; inspect finite outcome metadata and do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulEconomicMutationOutcomeUnknown"}}}},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"PATCH","x-kallfi-read-only":false}},"/v1/account/actions/getAccountSoulDiscountAudience":{"post":{"operationId":"getAccountSoulDiscountAudience","tags":["Account product actions"],"summary":"getAccountSoulDiscountAudience","description":"Prices/catalog/current ownership and commercial dependencies remain genuine native owner validation; no invented prices. Account Personal only; current actor, canonical surface and ownership remain authoritative. Explicit Team selection is rejected without fallback. No automatic mutation retry or invented replay journal.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAccountSoulDiscountAudienceRequest"}}}},"responses":{"200":{"description":"Canonical typed projection; acknowledgment is not terminal workflow success.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"policy":{"$ref":"#/components/schemas/AccountSoulDiscountPolicy"},"preview":{"anyOf":[{"$ref":"#/components/schemas/AccountSoulDiscountPreview"},{"type":"null"}]}},"required":["policy","preview"]}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"502":{"description":"Native response cannot be safely projected; inspect finite outcome metadata and do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulEconomicReadProjectionUnavailable"}}}},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"GET","x-kallfi-read-only":true}},"/v1/account/actions/updateAccountSoulDiscountAudience":{"post":{"operationId":"updateAccountSoulDiscountAudience","tags":["Account product actions"],"summary":"updateAccountSoulDiscountAudience","description":"Prices/catalog/current ownership and commercial dependencies remain genuine native owner validation; no invented prices. Account Personal only; current actor, canonical surface and ownership remain authoritative. Explicit Team selection is rejected without fallback. No automatic mutation retry or invented replay journal.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAccountSoulDiscountAudienceRequest"}}}},"responses":{"200":{"description":"Canonical typed projection; acknowledgment is not terminal workflow success.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"policy":{"$ref":"#/components/schemas/AccountSoulDiscountPolicy"}},"required":["policy"]}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"502":{"description":"Native response cannot be safely projected; inspect finite outcome metadata and do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulEconomicMutationOutcomeUnknown"}}}},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"PUT","x-kallfi-read-only":false}},"/v1/account/actions/updateAccountSoulMessageTerms":{"post":{"operationId":"updateAccountSoulMessageTerms","tags":["Account product actions"],"summary":"updateAccountSoulMessageTerms","description":"Prices/catalog/current ownership and commercial dependencies remain genuine native owner validation; no invented prices. Account Personal only; current actor, canonical surface and ownership remain authoritative. Explicit Team selection is rejected without fallback. No automatic mutation retry or invented replay journal.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAccountSoulMessageTermsRequest"}}}},"responses":{"200":{"description":"Canonical typed projection; acknowledgment is not terminal workflow success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulEconomicMutationAcknowledgment"}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"502":{"description":"Native response cannot be safely projected; inspect finite outcome metadata and do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulEconomicMutationOutcomeUnknown"}}}},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"PATCH","x-kallfi-read-only":false}},"/v1/account/actions/setAccountSoulMessageBudgetEnabled":{"post":{"operationId":"setAccountSoulMessageBudgetEnabled","tags":["Account product actions"],"summary":"setAccountSoulMessageBudgetEnabled","description":"Prices/catalog/current ownership and commercial dependencies remain genuine native owner validation; no invented prices. Account Personal only; current actor, canonical surface and ownership remain authoritative. Explicit Team selection is rejected without fallback. No automatic mutation retry or invented replay journal.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetAccountSoulMessageBudgetEnabledRequest"}}}},"responses":{"200":{"description":"Canonical typed projection; acknowledgment is not terminal workflow success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulEconomicMutationAcknowledgment"}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"502":{"description":"Native response cannot be safely projected; inspect finite outcome metadata and do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulEconomicMutationOutcomeUnknown"}}}},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"PATCH","x-kallfi-read-only":false}},"/v1/account/actions/prepareAccountSoulMessageBudget":{"post":{"operationId":"prepareAccountSoulMessageBudget","tags":["Account product actions"],"summary":"prepareAccountSoulMessageBudget","description":"Prices/catalog/current ownership and commercial dependencies remain genuine native owner validation; no invented prices. Account Personal only; current actor, canonical surface and ownership remain authoritative. Explicit Team selection is rejected without fallback. No automatic mutation retry or invented replay journal. Preparation persists or replaces a canonical quote without committing a wallet debit. Prepare and commit use the SAME funding-intent UUID. Commit must echo the genuine quote including action/entity/terms; never automatically accept a replacement quote.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrepareAccountSoulMessageBudgetRequest"}}}},"responses":{"200":{"description":"Canonical typed projection; acknowledgment is not terminal workflow success.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"quote":{"$ref":"#/components/schemas/AccountSoulFundingQuote"}},"required":["quote"]}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"402":{"description":"Canonical insufficient Gems admission; no funding success inferred."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"502":{"description":"Native response cannot be safely projected; inspect finite outcome metadata and do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulEconomicReadProjectionUnavailable"}}}},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"POST","x-kallfi-read-only":false}},"/v1/account/actions/commitAccountSoulMessageBudget":{"post":{"operationId":"commitAccountSoulMessageBudget","tags":["Account product actions"],"summary":"commitAccountSoulMessageBudget","description":"Prices/catalog/current ownership and commercial dependencies remain genuine native owner validation; no invented prices. Account Personal only; current actor, canonical surface and ownership remain authoritative. Explicit Team selection is rejected without fallback. No automatic mutation retry or invented replay journal. Preparation persists or replaces a canonical quote without committing a wallet debit. Prepare and commit use the SAME funding-intent UUID. Commit must echo the genuine quote including action/entity/terms; never automatically accept a replacement quote.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CommitAccountSoulMessageBudgetRequest"}}}},"responses":{"200":{"description":"Canonical typed projection; acknowledgment is not terminal workflow success.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"budget":{"$ref":"#/components/schemas/AccountSoulMessageBudgetSafe"}},"required":["budget"]}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"402":{"description":"Canonical insufficient Gems admission; no funding success inferred."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"502":{"description":"Native response cannot be safely projected; inspect finite outcome metadata and do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulEconomicMutationOutcomeUnknown"}}}},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"POST","x-kallfi-read-only":false}},"/v1/account/actions/getAccountSoulLikenessPolicy":{"post":{"operationId":"getAccountSoulLikenessPolicy","tags":["Account product actions"],"summary":"getAccountSoulLikenessPolicy","description":" Account Personal only; current actor, canonical surface and ownership remain authoritative. Explicit Team selection is rejected without fallback. No automatic mutation retry or invented replay journal.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAccountSoulLikenessPolicyRequest"}}}},"responses":{"200":{"description":"Canonical typed projection; acknowledgment is not terminal workflow success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulNonfinancialLikenessResponse"}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"GET","x-kallfi-read-only":true}},"/v1/account/actions/updateAccountSoulLikenessPolicy":{"post":{"operationId":"updateAccountSoulLikenessPolicy","tags":["Account product actions"],"summary":"updateAccountSoulLikenessPolicy","description":" Account Personal only; current actor, canonical surface and ownership remain authoritative. Explicit Team selection is rejected without fallback. No automatic mutation retry or invented replay journal.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAccountSoulLikenessPolicyRequest"}}}},"responses":{"200":{"description":"Canonical typed projection; acknowledgment is not terminal workflow success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulNonfinancialLikenessResponse"}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"502":{"description":"Native response cannot be safely projected; inspect finite outcome metadata and do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulMutationOutcomeUnknown"}}}},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"PATCH","x-kallfi-read-only":false}},"/v1/account/actions/updateAccountSoulSurfaceVisibility":{"post":{"operationId":"updateAccountSoulSurfaceVisibility","tags":["Account product actions"],"summary":"updateAccountSoulSurfaceVisibility","description":" Account Personal only; current actor, canonical surface and ownership remain authoritative. Explicit Team selection is rejected without fallback. No automatic mutation retry or invented replay journal.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAccountSoulSurfaceVisibilityRequest"}}}},"responses":{"200":{"description":"Canonical typed projection; acknowledgment is not terminal workflow success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulNonfinancialProfileResponse"}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"502":{"description":"Native response cannot be safely projected; inspect finite outcome metadata and do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulMutationOutcomeUnknown"}}}},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"PATCH","x-kallfi-read-only":false}},"/v1/account/actions/updateAccountSoulHandle":{"post":{"operationId":"updateAccountSoulHandle","tags":["Account product actions"],"summary":"updateAccountSoulHandle","description":" Account Personal only; current actor, canonical surface and ownership remain authoritative. Explicit Team selection is rejected without fallback. No automatic mutation retry or invented replay journal.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAccountSoulHandleRequest"}}}},"responses":{"200":{"description":"Canonical typed projection; acknowledgment is not terminal workflow success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulNonfinancialProfileResponse"}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"502":{"description":"Native response cannot be safely projected; inspect finite outcome metadata and do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulMutationOutcomeUnknown"}}}},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"PATCH","x-kallfi-read-only":false}},"/v1/account/actions/updateAccountSoulDisplayName":{"post":{"operationId":"updateAccountSoulDisplayName","tags":["Account product actions"],"summary":"updateAccountSoulDisplayName","description":" Account Personal only; current actor, canonical surface and ownership remain authoritative. Explicit Team selection is rejected without fallback. No automatic mutation retry or invented replay journal.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAccountSoulDisplayNameRequest"}}}},"responses":{"200":{"description":"Canonical typed projection; acknowledgment is not terminal workflow success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulNonfinancialDisplayNameResponse"}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"502":{"description":"Native response cannot be safely projected; inspect finite outcome metadata and do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulMutationOutcomeUnknown"}}}},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"PUT","x-kallfi-read-only":false}},"/v1/account/actions/updateAccountSoulBio":{"post":{"operationId":"updateAccountSoulBio","tags":["Account product actions"],"summary":"updateAccountSoulBio","description":" Account Personal only; current actor, canonical surface and ownership remain authoritative. Explicit Team selection is rejected without fallback. No automatic mutation retry or invented replay journal.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAccountSoulBioRequest"}}}},"responses":{"200":{"description":"Canonical typed projection; acknowledgment is not terminal workflow success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulNonfinancialBioResponse"}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"502":{"description":"Native response cannot be safely projected; inspect finite outcome metadata and do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulMutationOutcomeUnknown"}}}},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"PUT","x-kallfi-read-only":false}},"/v1/account/actions/deleteAccountSoul":{"post":{"operationId":"deleteAccountSoul","tags":["Account product actions"],"summary":"deleteAccountSoul","description":" Account Personal only; current actor, canonical surface and ownership remain authoritative. Explicit Team selection is rejected without fallback. No automatic mutation retry or invented replay journal. Body actionId and Idempotency-Key are the SAME original deletion UUID. A 202 response is nonterminal.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteAccountSoulRequest"}}}},"responses":{"200":{"description":"Canonical typed projection; acknowledgment is not terminal workflow success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulNonfinancialDeletionResponse"}}}},"202":{"description":"Deletion accepted or pending; inspect the explicit status lookup until terminal.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulNonfinancialDeletionResponse"}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"502":{"description":"Native response cannot be safely projected; inspect finite outcome metadata and do not automatically retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulMutationOutcomeUnknown"}}}},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"DELETE","x-kallfi-read-only":false}},"/v1/account/actions/getAccountSoulDeletionStatus":{"post":{"operationId":"getAccountSoulDeletionStatus","tags":["Account product actions"],"summary":"getAccountSoulDeletionStatus","description":" Account Personal only; current actor, canonical surface and ownership remain authoritative. Explicit Team selection is rejected without fallback. No automatic mutation retry or invented replay journal. Reuse the ORIGINAL deletion UUID header. Receipt ownership is checked without requiring an active Soul; this is not generation-operation lookup.","parameters":[{"in":"header","name":"Idempotency-Key","required":true,"schema":{"type":"string","format":"uuid"},"description":"Canonical action UUID; mutation retries reuse this key. Reads also require a UUID at the machine transport boundary."},{"name":"X-Kallfi-Workspace-ID","in":"header","required":false,"description":"Untrusted explicit workspace UUID. Omitted selects Personal. Workspace commands require current membership, role, surface and grant; explicit denied selection never falls back. Account-owned commands reject a nonpersonal selected workspace. One Account surface key spans currently authorized workspaces; selecting a workspace never issues another key.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetAccountSoulDeletionStatusRequest"}}}},"responses":{"200":{"description":"Canonical typed projection; acknowledgment is not terminal workflow success.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSoulDeletionStatusResponse"}}}},"400":{"description":"Canonical input/revision/receipt or finite query validation failure."},"401":{"description":"Credential/scope/grant/issuer/surface admission denied."},"403":{"description":"Canonical product/safety/ownership admission denied."},"404":{"description":"Canonical selected subject/entity/conversation not found."},"409":{"description":"Canonical revision, pricing or idempotency conflict."},"429":{"description":"Canonical rate/allowance limit."},"500":{"description":"Canonical owner internal failure; no success or terminal output inferred."},"503":{"description":"Canonical owner unavailable; no terminal success claimed."}},"x-kallfi-command-scope":"account","x-kallfi-canonical-method":"GET","x-kallfi-read-only":true}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"opaque organization credential","description":"Organization-scoped bearer credential. Credentials are scoped, revocable, and never represented by a Soul or operation ID."}},"parameters":{"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":true,"description":"Opaque replay key for this mutation. Repeating the same key with the same request returns the original result; reusing it with different input returns a conflict.","schema":{"type":"string","minLength":1,"maxLength":128}},"SoulId":{"name":"soul_id","in":"path","required":true,"description":"Company-scoped Kallfi Soul identifier.","schema":{"$ref":"#/components/schemas/SoulId"}},"OperationId":{"name":"operation_id","in":"path","required":true,"description":"Company-scoped asynchronous operation identifier.","schema":{"$ref":"#/components/schemas/OperationId"}}},"responses":{"SourceAssetAccepted":{"description":"Accepted. The upload intent and its asynchronous validation operation are available.","headers":{"Location":{"description":"URL of the operation resource.","schema":{"type":"string","format":"uri","maxLength":4096}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceAssetAcceptedResponse"}}}},"SoulAccepted":{"description":"Accepted. Soul creation continues as an asynchronous operation.","headers":{"Location":{"description":"URL of the operation resource.","schema":{"type":"string","format":"uri","maxLength":4096}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SoulAcceptedResponse"}}}},"SoulUpdateAccepted":{"description":"Accepted. The revision-checked Soul update continues as an asynchronous operation.","headers":{"Location":{"description":"URL of the operation resource.","schema":{"type":"string","format":"uri","maxLength":4096}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SoulUpdateAcceptedResponse"}}}},"ResponseAccepted":{"description":"Accepted. Response generation continues as an asynchronous operation.","headers":{"Location":{"description":"URL of the operation resource.","schema":{"type":"string","format":"uri","maxLength":4096}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationAcceptedResponse"}}}},"GenerationAccepted":{"description":"Accepted. Image or video generation continues as an asynchronous operation.","headers":{"Location":{"description":"URL of the operation resource.","schema":{"type":"string","format":"uri","maxLength":4096}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OperationAcceptedResponse"}}}},"SoulRead":{"description":"The current company-scoped Soul projection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Soul"}}}},"OperationRead":{"description":"The authoritative operation projection.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Operation"}}}},"BadRequest":{"description":"The request is malformed or violates the JSON contract.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Unauthorized":{"description":"Authentication is missing, invalid, expired, or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Forbidden":{"description":"The credential is authenticated but not authorized for this company-scoped resource or capability.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"NotFound":{"description":"The company-scoped resource does not exist or is not visible to this credential.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Conflict":{"description":"The replay key conflicts with a different request, the requested revision/capability cannot converge, or a surface-owned resource/operation was addressed with a different surface. For that last case the stable error code is surface_conflict; callers must branch on error.code rather than message text.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"surfaceConflict":{"summary":"Surface does not match the original operation","value":{"error":{"code":"surface_conflict","message":"The requested surface conflicts with the immutable operation surface.","request_id":"req_example"}}}}}}},"PayloadTooLarge":{"description":"The bounded JSON request exceeds the contract's byte, item, or text limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"UnsupportedMediaType":{"description":"The declared source media type is not accepted for the explicit source-asset role.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"UnprocessableEntity":{"description":"The request is structurally valid but fails a safety, rights, consent, capability, quote, or domain invariant.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"TooManyRequests":{"description":"The organization or service is over a bounded rate, concurrency, outstanding-operation, or spend limit.","headers":{"Retry-After":{"description":"Minimum delay in seconds before retrying, when known.","schema":{"type":"integer","minimum":0,"maximum":86400}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"InternalServerError":{"description":"The proposed service encountered an unexpected failure. The stable error envelope contains a request ID for support correlation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"ServiceUnavailable":{"description":"The proposed service cannot currently admit this request or a required capability is unavailable. No billable successful operation is created.","headers":{"Retry-After":{"description":"Minimum delay in seconds before retrying, when known.","schema":{"type":"integer","minimum":0,"maximum":86400}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"schemas":{"ErrorResponse":{"type":"object","additionalProperties":false,"required":["error"],"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message","request_id"],"properties":{"code":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,79}$","maxLength":80,"description":"Stable machine-readable error code."},"message":{"type":"string","minLength":1,"maxLength":500},"request_id":{"type":"string","minLength":1,"maxLength":128},"details":{"type":"object","maxProperties":8,"additionalProperties":{"type":"string","maxLength":256},"description":"Optional bounded diagnostic values. Clients must branch on code, not message or detail text."}}}}},"SoulId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^soul_[A-Za-z0-9][A-Za-z0-9._:-]{0,126}$","description":"Opaque company-scoped Soul identifier."},"OperationId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^op_[A-Za-z0-9][A-Za-z0-9._:-]{0,126}$","description":"Opaque company-scoped operation identifier."},"SourceAssetId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^ssa_[A-Za-z0-9][A-Za-z0-9._:-]{0,126}$","description":"Opaque company-scoped source-asset identifier."},"ExternalSoulId":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$","description":"Stable identifier chosen by the partner within its company scope."},"SoulKind":{"type":"string","enum":["human","creature"],"maxLength":16},"SourceAssetType":{"type":"string","enum":["appearance_reference","content_style_reference","text_video_timeline"],"maxLength":32},"WebSurface":{"type":"string","enum":["nsfw-disabled","nsfw-enabled"],"maxLength":13,"description":"Exact Kallfi web surface that owns a surface-scoped operation or resource."},"Lifecycle":{"type":"string","enum":["draft","active","suspended","deleted"],"maxLength":16},"MediaDeclaration":{"type":"object","additionalProperties":false,"required":["content_type","byte_length","sha256"],"properties":{"content_type":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[A-Za-z0-9!#$&^_.+-]+/[A-Za-z0-9!#$&^_.+-]+$"},"byte_length":{"type":"integer","minimum":1,"maximum":5000000000},"sha256":{"type":"string","minLength":64,"maxLength":64,"pattern":"^[a-f0-9]{64}$"}}},"RightsAttestation":{"type":"object","additionalProperties":false,"required":["basis","subject_consent"],"properties":{"basis":{"type":"string","enum":["owned_or_licensed"],"maxLength":32},"subject_consent":{"type":"boolean"}}},"TimelineAnnotation":{"type":"object","additionalProperties":false,"required":["request_at_ms","behavior_start_ms","behavior_end_ms","user_request"],"properties":{"request_at_ms":{"type":"integer","minimum":0,"maximum":86400000},"behavior_start_ms":{"type":"integer","minimum":0,"maximum":86400000},"behavior_end_ms":{"type":"integer","minimum":1,"maximum":86400000},"user_request":{"type":"string","minLength":1,"maxLength":2000}}},"SourceAssetCreateRequest":{"type":"object","additionalProperties":false,"required":["type","media","rights_attestation"],"properties":{"type":{"$ref":"#/components/schemas/SourceAssetType"},"media":{"$ref":"#/components/schemas/MediaDeclaration"},"annotations":{"type":"array","minItems":1,"maxItems":128,"items":{"$ref":"#/components/schemas/TimelineAnnotation"},"description":"Required only for text_video_timeline; annotations must be ordered, in-bounds, and non-overlapping."},"rights_attestation":{"$ref":"#/components/schemas/RightsAttestation"}},"allOf":[{"if":{"properties":{"type":{"const":"text_video_timeline"}},"required":["type"]},"then":{"required":["annotations"]},"else":{"properties":{"annotations":{"maxItems":0}}}}]},"UploadTarget":{"type":"object","additionalProperties":false,"required":["method","url","expires_at"],"properties":{"method":{"type":"string","const":"PUT","maxLength":3},"url":{"type":"string","format":"uri","minLength":1,"maxLength":4096},"expires_at":{"type":"string","format":"date-time","minLength":1,"maxLength":64},"headers":{"type":"object","maxProperties":8,"additionalProperties":{"type":"string","maxLength":512},"description":"Optional bounded headers required by the direct-upload target."}}},"SourceAssetStatus":{"type":"string","enum":["upload_pending","validating","ready","rejected","expired"],"maxLength":16},"SourceAsset":{"type":"object","additionalProperties":false,"required":["source_asset_id","type","status","media","rights_attestation","upload","created_at"],"properties":{"source_asset_id":{"$ref":"#/components/schemas/SourceAssetId"},"type":{"$ref":"#/components/schemas/SourceAssetType"},"status":{"$ref":"#/components/schemas/SourceAssetStatus"},"media":{"$ref":"#/components/schemas/MediaDeclaration"},"annotations":{"type":"array","maxItems":128,"items":{"$ref":"#/components/schemas/TimelineAnnotation"}},"rights_attestation":{"$ref":"#/components/schemas/RightsAttestation"},"upload":{"$ref":"#/components/schemas/UploadTarget"},"created_at":{"type":"string","format":"date-time","maxLength":64}}},"SoulCreateRequest":{"type":"object","additionalProperties":false,"required":["external_soul_id","kind","description","source_asset_ids"],"properties":{"external_soul_id":{"$ref":"#/components/schemas/ExternalSoulId"},"kind":{"$ref":"#/components/schemas/SoulKind"},"description":{"type":"string","minLength":1,"maxLength":4000},"source_asset_ids":{"type":"array","minItems":0,"maxItems":16,"uniqueItems":true,"items":{"$ref":"#/components/schemas/SourceAssetId"},"description":"Ordered, immutable source-asset manifest. Use an empty array for description-only creation."}}},"SoulUpdateRequest":{"type":"object","additionalProperties":false,"required":["expected_revision"],"properties":{"expected_revision":{"type":"integer","minimum":1,"maximum":2147483647},"description":{"type":"string","minLength":1,"maxLength":4000}},"description":"At least one allowed mutable field should accompany expected_revision. Kind, external_soul_id, and the accepted source-asset manifest are immutable in v1."},"SoulCapabilities":{"type":"object","additionalProperties":false,"required":["responses","image_generation","video_generation"],"properties":{"responses":{"type":"boolean"},"image_generation":{"type":"boolean"},"video_generation":{"type":"boolean"}}},"Soul":{"type":"object","additionalProperties":false,"required":["soul_id","external_soul_id","kind","description","lifecycle","revision","source_asset_ids","capabilities","created_at","updated_at"],"properties":{"soul_id":{"$ref":"#/components/schemas/SoulId"},"external_soul_id":{"$ref":"#/components/schemas/ExternalSoulId"},"kind":{"$ref":"#/components/schemas/SoulKind"},"description":{"type":"string","minLength":1,"maxLength":4000},"lifecycle":{"$ref":"#/components/schemas/Lifecycle"},"revision":{"type":"integer","minimum":1,"maximum":2147483647},"source_asset_ids":{"type":"array","maxItems":16,"uniqueItems":true,"items":{"$ref":"#/components/schemas/SourceAssetId"}},"capabilities":{"$ref":"#/components/schemas/SoulCapabilities"},"created_at":{"type":"string","format":"date-time","maxLength":64},"updated_at":{"type":"string","format":"date-time","maxLength":64}}},"ConversationMessage":{"type":"object","additionalProperties":false,"required":["role","content"],"properties":{"role":{"type":"string","enum":["user","assistant"],"maxLength":9},"content":{"type":"string","minLength":1,"maxLength":8000}}},"ResponseCreateRequest":{"type":"object","additionalProperties":false,"required":["surface","messages"],"properties":{"surface":{"$ref":"#/components/schemas/WebSurface","description":"Required surface for the new Soul conversation/response operation."},"messages":{"type":"array","minItems":1,"maxItems":64,"items":{"$ref":"#/components/schemas/ConversationMessage"},"description":"Ordered, bounded conversation context supplied by the partner."},"max_output_tokens":{"type":"integer","minimum":1,"maximum":2048}}},"QuoteReference":{"type":"object","additionalProperties":false,"required":["quote_id"],"properties":{"quote_id":{"type":"string","minLength":1,"maxLength":128}}},"GenerationCreateRequest":{"type":"object","additionalProperties":false,"required":["surface","kind","prompt","quote_id"],"properties":{"surface":{"$ref":"#/components/schemas/WebSurface","description":"Required surface for the new image or video operation and its output."},"kind":{"type":"string","enum":["image","video"],"maxLength":5},"prompt":{"type":"string","minLength":1,"maxLength":4000},"quote_id":{"type":"string","minLength":1,"maxLength":128,"description":"Opaque server-issued quote identifier; clients do not calculate Gem amounts."},"duration_ms":{"type":"integer","minimum":1000,"maximum":120000,"description":"Requested video duration. Required for video and ignored for image only when the server explicitly documents that behavior."},"source_asset_ids":{"type":"array","maxItems":8,"uniqueItems":true,"items":{"$ref":"#/components/schemas/SourceAssetId"}}},"allOf":[{"if":{"properties":{"kind":{"const":"video"}},"required":["kind"]},"then":{"required":["duration_ms"]}}]},"ResourceReference":{"type":"object","additionalProperties":false,"required":["type","id"],"properties":{"type":{"type":"string","enum":["source_asset","soul","response","generation"],"maxLength":16},"id":{"type":"string","minLength":1,"maxLength":128}}},"OperationKind":{"type":"string","enum":["source_asset_validation","soul_creation","soul_update","soul_response","image_generation","video_generation"],"maxLength":32},"OperationStatus":{"type":"string","enum":["accepted","submitted","running","acceptance_unknown","succeeded","failed","canceled"],"maxLength":20},"OperationFailure":{"type":"object","additionalProperties":false,"required":["code","message","retryable"],"properties":{"code":{"type":"string","pattern":"^[a-z][a-z0-9_]{0,79}$","maxLength":80},"message":{"type":"string","minLength":1,"maxLength":500},"retryable":{"type":"boolean"}}},"OperationUsage":{"type":"object","additionalProperties":false,"required":["reserved_gems","consumed_gems","released_gems"],"properties":{"reserved_gems":{"type":"integer","minimum":0,"maximum":1000000000},"consumed_gems":{"type":"integer","minimum":0,"maximum":1000000000},"released_gems":{"type":"integer","minimum":0,"maximum":1000000000}}},"MediaLocator":{"description":"Authorized media delivery locator. Ordinary direct Cloudflare image URLs have no expiry; expiring video or other capability locators include expires_at. Application authorization and immutable operation surface precede issuance. A direct image URL is not a revocable or surface-bound bearer capability.","oneOf":[{"$ref":"#/components/schemas/DirectImageLocator"},{"$ref":"#/components/schemas/ExpiringMediaLocator"}]},"DirectImageLocator":{"type":"object","additionalProperties":false,"description":"Ordinary direct image URL returned after application authorization. Cloudflare Images use this form; expires_at is omitted, not synthesized.","required":["kind","url"],"properties":{"kind":{"type":"string","const":"image"},"url":{"type":"string","format":"uri","minLength":1,"maxLength":4096}}},"ExpiringMediaLocator":{"type":"object","additionalProperties":false,"description":"Expiring video playback or another explicitly authorized gateway capability. Mux playback retains its existing authorization and expiry.","required":["kind","url","expires_at"],"properties":{"kind":{"type":"string","enum":["image","video"],"maxLength":5},"url":{"type":"string","format":"uri","minLength":1,"maxLength":4096},"expires_at":{"type":"string","format":"date-time","maxLength":64}}},"OperationOutput":{"type":"object","additionalProperties":false,"required":["kind"],"properties":{"kind":{"type":"string","enum":["text","image","video"],"maxLength":5},"text":{"type":"string","minLength":1,"maxLength":20000},"media":{"type":"array","maxItems":8,"items":{"$ref":"#/components/schemas/MediaLocator"}}}},"OperationLinks":{"type":"object","additionalProperties":false,"required":["self"],"properties":{"self":{"type":"string","format":"uri","minLength":1,"maxLength":4096}}},"OperationBase":{"type":"object","description":"Common operation fields. The concrete operation schema adds its kind discriminant and, for surface-owned work, its immutable surface.","required":["operation_id","status","created_at","updated_at"],"properties":{"operation_id":{"$ref":"#/components/schemas/OperationId"},"status":{"$ref":"#/components/schemas/OperationStatus"},"resource":{"$ref":"#/components/schemas/ResourceReference"},"progress_percent":{"type":"integer","minimum":0,"maximum":100},"quote":{"$ref":"#/components/schemas/QuoteReference"},"usage":{"$ref":"#/components/schemas/OperationUsage"},"failure":{"$ref":"#/components/schemas/OperationFailure"},"output":{"$ref":"#/components/schemas/OperationOutput"},"created_at":{"type":"string","format":"date-time","maxLength":64},"updated_at":{"type":"string","format":"date-time","maxLength":64},"links":{"$ref":"#/components/schemas/OperationLinks"}}},"SharedOperation":{"description":"Surface-neutral operation for source-asset validation or shared Soul identity work. It must omit surface.","allOf":[{"$ref":"#/components/schemas/OperationBase"},{"type":"object","properties":{"kind":{"type":"string","enum":["source_asset_validation","soul_creation","soul_update"]}},"required":["kind"]}]},"SurfaceOwnedOperation":{"description":"Surface-owned response or generation operation. Its surface is required and immutable after acceptance.","allOf":[{"$ref":"#/components/schemas/OperationBase"},{"type":"object","properties":{"kind":{"type":"string","enum":["soul_response","image_generation","video_generation"]},"surface":{"$ref":"#/components/schemas/WebSurface","description":"Immutable surface derived from the accepted request."}},"required":["kind","surface"]}]},"Operation":{"description":"Concrete operation union. Shared source-asset and Soul identity operations omit surface; response and generation operations require their immutable surface.","oneOf":[{"$ref":"#/components/schemas/SharedOperation"},{"$ref":"#/components/schemas/SurfaceOwnedOperation"}],"discriminator":{"propertyName":"kind","mapping":{"source_asset_validation":"#/components/schemas/SharedOperation","soul_creation":"#/components/schemas/SharedOperation","soul_update":"#/components/schemas/SharedOperation","soul_response":"#/components/schemas/SurfaceOwnedOperation","image_generation":"#/components/schemas/SurfaceOwnedOperation","video_generation":"#/components/schemas/SurfaceOwnedOperation"}},"unevaluatedProperties":false},"OperationAcceptedResponse":{"type":"object","additionalProperties":false,"required":["operation"],"properties":{"operation":{"$ref":"#/components/schemas/Operation"}}},"SourceAssetAcceptedResponse":{"type":"object","additionalProperties":false,"required":["source_asset","operation"],"properties":{"source_asset":{"$ref":"#/components/schemas/SourceAsset"},"operation":{"$ref":"#/components/schemas/Operation"}}},"SoulAcceptedResponse":{"type":"object","additionalProperties":false,"required":["soul","operation"],"properties":{"soul":{"$ref":"#/components/schemas/Soul"},"operation":{"$ref":"#/components/schemas/Operation"}}},"SoulUpdateAcceptedResponse":{"type":"object","additionalProperties":false,"required":["soul","operation"],"properties":{"soul":{"$ref":"#/components/schemas/Soul"},"operation":{"$ref":"#/components/schemas/Operation"}}},"ProductActionIdempotencyKey":{"type":"string","format":"uuid","description":"Canonical product action UUID. Reuse for retries of the same action. Pricing and generation launch use distinct action UUIDs."},"ManagedProductSoulId":{"type":"string","format":"uuid","description":"Canonical managed Soul UUID, distinct from company-scoped soul_ identifiers used by the existing seven enterprise operations."},"ProductSoulMonetizationRequest":{"type":"object","additionalProperties":false,"properties":{"expectedProjectionRevision":{"type":"string","pattern":"^[0-9]+$"},"replacedSoulId":{"type":["string","null"],"format":"uuid"}},"required":["expectedProjectionRevision"]},"ProductSoulUnmonetizationRequest":{"type":"object","additionalProperties":false,"properties":{"expectedProjectionRevision":{"type":"string","pattern":"^[0-9]+$"}},"required":["expectedProjectionRevision"]},"ProductSoulPublishRequest":{"type":"object","additionalProperties":false,"properties":{}},"ProductPostRequest":{"type":"object","additionalProperties":false,"properties":{"caption":{"type":"string"},"mediaType":{"type":"string","enum":["image","video"]},"entityId":{"type":["string","null"],"format":"uuid"},"mediaAttachments":{"type":"array","items":{"type":"object"}},"imageAttachments":{"type":"array","items":{"type":"object"}},"mediaFitMode":{"type":"string"},"muxUploadId":{"type":"string"},"muxAssetId":{"type":"string"},"muxPlaybackId":{"type":"string"},"duration":{"type":"number"},"rawDimensions":{"type":"object"},"matteAnalysis":{"type":"object"},"cloudflareImageId":{"type":"string"},"imageUrl":{"type":"string"},"pendingUploadId":{"type":"string","format":"uuid"},"isPrivate":{"type":"boolean"},"privateAccessMode":{"type":"string"},"ppvCostGems":{"type":"number"},"involvedSouls":{"type":"array","items":{"type":"object"}}},"required":["caption","mediaType"],"description":"Canonical /api/post payload. Use the upload intent and finalize protocol first; arbitrary URL ownership is never accepted. Caption safety, upload ownership/consent, participant cardinality, rate limits and gated-media rules execute in the canonical owner."},"ProductMediaUploadRequest":{"type":"object","properties":{"operation":{"type":"string","enum":["create","finalize"]},"surface":{"type":"string","description":"Product upload purpose, e.g. post. This never selects .com/.red."},"mediaType":{"type":"string","enum":["image","video"]},"imageId":{"type":"string"},"pendingId":{"type":"string","format":"uuid"}},"required":["surface","mediaType"],"description":"Canonical /api/media/upload declaration. Retain provider fields from the existing product upload contract. POST operation=create (default) issues the owned direct-upload destination; upload bytes to it; POST operation=finalize finalizes supported image uploads. Surface-specific policy is derived from the API hostname."},"ProductGenerateRequest":{"type":"object","additionalProperties":false,"properties":{"version":{"type":"integer","enum":[2,3]},"safetyClass":{"enum":["sfw","nsfw"]},"outputOwner":{"type":"object","additionalProperties":false,"properties":{"entityId":{"type":["string","null"],"format":"uuid"}},"required":["entityId"]},"prompt":{"type":"string"},"controls":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"modality":{"const":"image"},"quality":{"enum":["low","regular","high"]},"durationSeconds":{"type":"null"}},"required":["modality","quality","durationSeconds"]},{"type":"object","additionalProperties":false,"properties":{"modality":{"const":"video"},"quality":{"enum":["low","regular","high"]},"durationSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["modality","quality","durationSeconds"]}]},"references":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"source":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"type":{"const":"post_image"},"postId":{"type":"string","format":"uuid"},"position":{"type":"integer","minimum":0},"assetId":{"type":["string","null"]}},"required":["type","postId","position"]},{"type":"object","additionalProperties":false,"properties":{"type":{"const":"post_video_frame"},"postId":{"type":"string","format":"uuid"},"position":{"type":"integer","minimum":0},"assetId":{"type":"string","format":"uuid"},"frameTimeSeconds":{"type":"number","minimum":0}},"required":["type","postId","position","assetId","frameTimeSeconds"]},{"type":"object","additionalProperties":false,"properties":{"type":{"const":"uploaded_asset"},"assetId":{"type":"string","format":"uuid"},"pendingUploadId":{"type":"string","format":"uuid"},"mediaType":{"enum":["image","video"]}},"required":["type","assetId","pendingUploadId","mediaType"]},{"type":"object","additionalProperties":false,"properties":{"type":{"const":"media_asset"},"assetId":{"type":"string","format":"uuid"}},"required":["type","assetId"]}]}},"required":["id","source"]}},"upfrontPricingAuthorization":{"type":"object","description":"Opaque canonical pricing response authorization; round-trip unchanged."},"expectedCommercialCommitment":{"type":"object"},"refinementActionId":{"type":"string","format":"uuid"},"refinementPreparationId":{"type":"string","format":"uuid"}},"required":["version","outputOwner","prompt","controls","references"],"description":"Canonical Generate request (current version 3; legacy 2 retained). Call generation-pricing with this body first, then pass the returned opaque upfrontPricingAuthorization into generations with a new Idempotency-Key. The canonical owner enforces accepted controls, reference rights, safety, balance, quote freshness, durable launch and output publication."},"AccountConversationStartBody":{"type":"object","additionalProperties":false,"properties":{"targetUserId":{"type":"string","format":"uuid"},"recipientEntityId":{"type":["string","null"],"format":"uuid"},"entityId":{"type":["string","null"],"format":"uuid"}},"required":["targetUserId"]},"AccountConversationSendBody":{"type":"object","properties":{"body":{"type":"string"},"media":{"type":"array","items":{"type":"object"}},"lockOffer":{"type":"boolean"},"offerCost":{"type":["number","null"]},"recipientEntityId":{"type":["string","null"],"format":"uuid"},"replyToMessageId":{"type":"string","format":"uuid"},"nextMessageBilling":{"type":"object"},"billing":{"type":"object"}},"description":"Canonical message command body; existing allowance, next-message billing, quote confirmation, recipient, safety and attachment validators remain authoritative. Send acceptance enqueues normal Soul auto-response; read the same conversation for its terminal message."},"CreateAccountSoulRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","properties":{"setupActionId":{"type":"string","format":"uuid"},"actionId":{"type":"string","format":"uuid"},"sourceDescription":{"type":"string"},"requestedIdentity":{"type":"object"},"pendingUploadId":{"type":"string","format":"uuid"},"cloudflareImageId":{"type":"string"},"references":{"type":"array","items":{"type":"object"}},"expectedCommercialCommitment":{"type":"object"}},"description":"Unmodified canonical product command body. This operation delegates all body semantics to the existing product owner; follow the canonical wizard revisions, selected output IDs, references and pricing receipts. No arbitrary handler, account actor, host or method is accepted. Listed body fields follow the existing canonical handler; canonical parsers retain final validation. UUID actionId for setup/looks/voice and publishIntentId for promotion are supplied from Idempotency-Key and cannot conflict."},"query":{"type":"object","additionalProperties":false,"properties":{}}}},"GetAccountSoulRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","additionalProperties":false,"properties":{}},"query":{"type":"object","additionalProperties":false,"properties":{"entityId":{"type":"string","maxLength":2048}}}}},"ListAccountSoulDraftsRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","additionalProperties":false,"properties":{}},"query":{"type":"object","additionalProperties":false,"properties":{}}}},"GetAccountSoulDraftRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","additionalProperties":false,"properties":{}},"query":{"type":"object","additionalProperties":false,"properties":{"draftId":{"type":"string","maxLength":2048},"inspiration":{"type":"string","maxLength":2048}}}}},"UpdateAccountSoulDetailsRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","properties":{"draftId":{"type":"string","format":"uuid"},"expectedRevision":{"type":"integer","minimum":1},"profileHandle":{"type":"string"},"publicHandlePolicyVersion":{"type":"integer","const":3},"displayName":{"type":"string"},"spokenLanguages":{"type":"array","items":{"type":"string"}},"lore":{"type":"string"},"soulTagging":{"type":"object"}},"description":"Unmodified canonical product command body. This operation delegates all body semantics to the existing product owner; follow the canonical wizard revisions, selected output IDs, references and pricing receipts. No arbitrary handler, account actor, host or method is accepted. Listed body fields follow the existing canonical handler; canonical parsers retain final validation. UUID actionId for setup/looks/voice and publishIntentId for promotion are supplied from Idempotency-Key and cannot conflict."},"query":{"type":"object","additionalProperties":false,"properties":{}}}},"GenerateAccountSoulLooksRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","properties":{"draftId":{"type":"string","format":"uuid"},"expectedRevision":{"type":"integer","minimum":1},"actionId":{"type":"string","format":"uuid"},"sourceDescription":{"type":"string"},"requestedIdentity":{"type":"object"},"references":{"type":"array","items":{"type":"object"}},"pendingUploadId":{"type":"string","format":"uuid"},"cloudflareImageId":{"type":"string"},"expectedCommercialCommitment":{"type":"object"}},"description":"Unmodified canonical product command body. This operation delegates all body semantics to the existing product owner; follow the canonical wizard revisions, selected output IDs, references and pricing receipts. No arbitrary handler, account actor, host or method is accepted. Listed body fields follow the existing canonical handler; canonical parsers retain final validation. UUID actionId for setup/looks/voice and publishIntentId for promotion are supplied from Idempotency-Key and cannot conflict."},"query":{"type":"object","additionalProperties":false,"properties":{}}}},"GenerateAccountSoulVoiceRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","properties":{"draftId":{"type":"string","format":"uuid"},"expectedRevision":{"type":"integer","minimum":1},"actionId":{"type":"string","format":"uuid"},"prompt":{"type":"string"},"expectedCommercialCommitment":{"type":"object"}},"description":"Unmodified canonical product command body. This operation delegates all body semantics to the existing product owner; follow the canonical wizard revisions, selected output IDs, references and pricing receipts. No arbitrary handler, account actor, host or method is accepted. Listed body fields follow the existing canonical handler; canonical parsers retain final validation. UUID actionId for setup/looks/voice and publishIntentId for promotion are supplied from Idempotency-Key and cannot conflict."},"query":{"type":"object","additionalProperties":false,"properties":{}}}},"SelectAccountSoulVoiceRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","properties":{"draftId":{"type":"string","format":"uuid"},"expectedRevision":{"type":"integer","minimum":1},"candidateId":{"type":"string","format":"uuid"}},"description":"Unmodified canonical product command body. This operation delegates all body semantics to the existing product owner; follow the canonical wizard revisions, selected output IDs, references and pricing receipts. No arbitrary handler, account actor, host or method is accepted. Listed body fields follow the existing canonical handler; canonical parsers retain final validation. UUID actionId for setup/looks/voice and publishIntentId for promotion are supplied from Idempotency-Key and cannot conflict."},"query":{"type":"object","additionalProperties":false,"properties":{}}}},"UpdateAccountSoulLanguagesRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","properties":{"draftId":{"type":"string","format":"uuid"},"expectedDetailsRevision":{"type":"integer","minimum":1},"expectedRevision":{"type":"integer","minimum":1},"spokenLanguages":{"type":"array","items":{"type":"string"}}},"description":"Unmodified canonical product command body. This operation delegates all body semantics to the existing product owner; follow the canonical wizard revisions, selected output IDs, references and pricing receipts. No arbitrary handler, account actor, host or method is accepted. Listed body fields follow the existing canonical handler; canonical parsers retain final validation. UUID actionId for setup/looks/voice and publishIntentId for promotion are supplied from Idempotency-Key and cannot conflict."},"query":{"type":"object","additionalProperties":false,"properties":{}}}},"ReviewAccountSoulRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","properties":{"draftId":{"type":"string","format":"uuid"},"expectedRevision":{"type":"integer","minimum":1},"age":{"type":"integer"}},"description":"Unmodified canonical product command body. This operation delegates all body semantics to the existing product owner; follow the canonical wizard revisions, selected output IDs, references and pricing receipts. No arbitrary handler, account actor, host or method is accepted. Listed body fields follow the existing canonical handler; canonical parsers retain final validation. UUID actionId for setup/looks/voice and publishIntentId for promotion are supplied from Idempotency-Key and cannot conflict."},"query":{"type":"object","additionalProperties":false,"properties":{}}}},"PromoteAccountSoulRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","properties":{"draftId":{"type":"string","format":"uuid"},"expectedRevision":{"type":"integer","minimum":1},"expectedDetailsRevision":{"type":"integer","minimum":1},"displayName":{"type":"string"},"profileHandle":{"type":"string"},"publicHandlePolicyVersion":{"type":"integer","const":3},"spokenLanguages":{"type":"array","items":{"type":"string"}},"loreInput":{"type":"string"},"publishIntentId":{"type":"string","format":"uuid"}},"description":"Unmodified canonical product command body. This operation delegates all body semantics to the existing product owner; follow the canonical wizard revisions, selected output IDs, references and pricing receipts. No arbitrary handler, account actor, host or method is accepted. Listed body fields follow the existing canonical handler; canonical parsers retain final validation. UUID actionId for setup/looks/voice and publishIntentId for promotion are supplied from Idempotency-Key and cannot conflict."},"query":{"type":"object","additionalProperties":false,"properties":{}}}},"GetAccountSoulLoreRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","additionalProperties":false,"properties":{}},"query":{"type":"object","additionalProperties":false,"properties":{"entityId":{"type":"string","maxLength":2048}}}}},"UpdateAccountSoulLoreRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","properties":{"entityId":{"type":"string","format":"uuid"},"extension":{"type":"string"},"addition":{"type":"string"},"soulTagging":{"type":"object"}},"description":"Unmodified canonical product command body. This operation delegates all body semantics to the existing product owner; follow the canonical wizard revisions, selected output IDs, references and pricing receipts. No arbitrary handler, account actor, host or method is accepted. Listed body fields follow the existing canonical handler; canonical parsers retain final validation. UUID actionId for setup/looks/voice and publishIntentId for promotion are supplied from Idempotency-Key and cannot conflict."},"query":{"type":"object","additionalProperties":false,"properties":{}}}},"CreateAccountSoulReferenceUploadRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","properties":{},"description":"Unmodified canonical product command body. This operation delegates all body semantics to the existing product owner; follow the canonical wizard revisions, selected output IDs, references and pricing receipts. No arbitrary handler, account actor, host or method is accepted. Listed body fields follow the existing canonical handler; canonical parsers retain final validation. UUID actionId for setup/looks/voice and publishIntentId for promotion are supplied from Idempotency-Key and cannot conflict."},"query":{"type":"object","additionalProperties":false,"properties":{}}}},"FinalizeAccountSoulReferenceUploadRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","properties":{"imageId":{"type":"string"},"pendingId":{"type":"string","format":"uuid"}},"description":"Unmodified canonical product command body. This operation delegates all body semantics to the existing product owner; follow the canonical wizard revisions, selected output IDs, references and pricing receipts. No arbitrary handler, account actor, host or method is accepted. Listed body fields follow the existing canonical handler; canonical parsers retain final validation. UUID actionId for setup/looks/voice and publishIntentId for promotion are supplied from Idempotency-Key and cannot conflict."},"query":{"type":"object","additionalProperties":false,"properties":{}}}},"AbandonAccountSoulDraftRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","properties":{"draftId":{"type":"string","format":"uuid"},"expectedRevision":{"type":"integer","minimum":1}},"description":"Unmodified canonical product command body. This operation delegates all body semantics to the existing product owner; follow the canonical wizard revisions, selected output IDs, references and pricing receipts. No arbitrary handler, account actor, host or method is accepted. Listed body fields follow the existing canonical handler; canonical parsers retain final validation. UUID actionId for setup/looks/voice and publishIntentId for promotion are supplied from Idempotency-Key and cannot conflict."},"query":{"type":"object","additionalProperties":false,"properties":{}}}},"DeleteAccountSoulDraftRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","properties":{"draftId":{"type":"string","format":"uuid"},"expectedRevision":{"type":"integer","minimum":1}},"description":"Unmodified canonical product command body. This operation delegates all body semantics to the existing product owner; follow the canonical wizard revisions, selected output IDs, references and pricing receipts. No arbitrary handler, account actor, host or method is accepted. Listed body fields follow the existing canonical handler; canonical parsers retain final validation. UUID actionId for setup/looks/voice and publishIntentId for promotion are supplied from Idempotency-Key and cannot conflict."},"query":{"type":"object","additionalProperties":false,"properties":{}}}},"PrepareAccountSoulEditSeedRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","properties":{"draftId":{"type":"string","format":"uuid"},"expectedRevision":{"type":"integer","minimum":1}},"description":"Unmodified canonical product command body. This operation delegates all body semantics to the existing product owner; follow the canonical wizard revisions, selected output IDs, references and pricing receipts. No arbitrary handler, account actor, host or method is accepted. Listed body fields follow the existing canonical handler; canonical parsers retain final validation. UUID actionId for setup/looks/voice and publishIntentId for promotion are supplied from Idempotency-Key and cannot conflict."},"query":{"type":"object","additionalProperties":false,"properties":{}}}},"CheckAccountSoulHandleRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","additionalProperties":false,"properties":{}},"query":{"type":"object","additionalProperties":false,"properties":{"draftId":{"type":"string","maxLength":2048},"publicHandlePolicyVersion":{"type":"string","maxLength":2048},"handle":{"type":"string","maxLength":2048}}}}},"StartAccountSoulConversationRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"$ref":"#/components/schemas/AccountConversationStartBody"},"query":{"type":"object","additionalProperties":false,"properties":{}}}},"CreateAccountSoulResponseRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"$ref":"#/components/schemas/AccountConversationSendBody"},"query":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","maxLength":2048},"messageId":{"type":"string","maxLength":2048},"targetWindow":{"type":"string","maxLength":2048},"limit":{"type":"string","maxLength":2048},"cursor":{"type":"string","maxLength":2048},"pricingOnly":{"type":"string","maxLength":2048},"entityId":{"type":"string","maxLength":2048}},"required":["id"]}},"required":["query"]},"GetAccountSoulResponsesRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","additionalProperties":false,"properties":{}},"query":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","maxLength":2048},"messageId":{"type":"string","maxLength":2048},"targetWindow":{"type":"string","maxLength":2048},"limit":{"type":"string","maxLength":2048},"cursor":{"type":"string","maxLength":2048},"pricingOnly":{"type":"string","maxLength":2048},"entityId":{"type":"string","maxLength":2048}},"required":["id"]}},"required":["query"]},"GetAccountOperationRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","additionalProperties":false,"properties":{}},"query":{"type":"object","additionalProperties":false,"properties":{"workflowId":{"type":"string","maxLength":2048},"requestId":{"type":"string","maxLength":2048},"generationId":{"type":"string","maxLength":2048},"generationIds":{"type":"string","maxLength":2048},"surface":{"type":"string","maxLength":2048},"contextKey":{"type":"string","maxLength":2048},"requesterType":{"enum":["account","soul"]},"requesterEntityId":{"type":"string","maxLength":2048},"targetSoulId":{"type":"string","maxLength":2048}},"required":["surface","contextKey","requesterType"],"description":"Exact normal-product observation scope returned/used by the originating generation journey. surface is product observation context, never .com/.red authority. requesterEntityId identifies an owned Soul; canonical loader checks ownership and the request owner."}},"required":["query"]},"GetAccountCreatorPlanRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"type":"object","additionalProperties":false},"query":{"type":"object","additionalProperties":false,"properties":{"historyLimit":{"type":"string","pattern":"^[0-9]+$","description":"Canonical owner clamps the bounded billing history page limit."}}}}},"ProductGeneratePricingRequest":{"type":"object","additionalProperties":false,"properties":{"version":{"type":"integer","enum":[2,3]},"safetyClass":{"enum":["sfw","nsfw"]},"outputOwner":{"type":"object","additionalProperties":false,"properties":{"entityId":{"type":["string","null"],"format":"uuid"}},"required":["entityId"]},"prompt":{"type":"string"},"controls":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"modality":{"const":"image"},"quality":{"enum":["low","regular","high"]},"durationSeconds":{"type":"null"}},"required":["modality","quality","durationSeconds"]},{"type":"object","additionalProperties":false,"properties":{"modality":{"const":"video"},"quality":{"enum":["low","regular","high"]},"durationSeconds":{"type":"integer","exclusiveMinimum":0}},"required":["modality","quality","durationSeconds"]}]},"references":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string"},"source":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"type":{"const":"post_image"},"postId":{"type":"string","format":"uuid"},"position":{"type":"integer","minimum":0},"assetId":{"type":["string","null"]}},"required":["type","postId","position"]},{"type":"object","additionalProperties":false,"properties":{"type":{"const":"post_video_frame"},"postId":{"type":"string","format":"uuid"},"position":{"type":"integer","minimum":0},"assetId":{"type":"string","format":"uuid"},"frameTimeSeconds":{"type":"number","minimum":0}},"required":["type","postId","position","assetId","frameTimeSeconds"]},{"type":"object","additionalProperties":false,"properties":{"type":{"const":"uploaded_asset"},"assetId":{"type":"string","format":"uuid"},"pendingUploadId":{"type":"string","format":"uuid"},"mediaType":{"enum":["image","video"]}},"required":["type","assetId","pendingUploadId","mediaType"]},{"type":"object","additionalProperties":false,"properties":{"type":{"const":"media_asset"},"assetId":{"type":"string","format":"uuid"}},"required":["type","assetId"]}]}},"required":["id","source"]}},"upfrontPricingAuthorization":{"type":"object","description":"Opaque canonical pricing response authorization; round-trip unchanged."},"expectedCommercialCommitment":{"type":"object"},"refinementActionId":{"type":"string","format":"uuid"},"refinementPreparationId":{"type":"string","format":"uuid"},"pricingActionId":{"type":"string","format":"uuid","description":"Bound to UUID Idempotency-Key by the authenticated dispatcher. Omit or send the identical UUID; retain for quote retries."}},"required":["version","outputOwner","prompt","controls","references"],"description":"Canonical Generate pricing preparation body. The dispatcher supplies pricingActionId from Idempotency-Key; the normal pricing owner binds quote/reference/commercial receipts to this Account and surface. Launch generation separately using the returned authorization and a new UUID action key."},"SponsorshipIndependenceCorrectionResolution":{"type":"string","enum":["not_required","pending","corrected","already_satisfied","refunded_before_correction","manual_conflict"]},"CreatorPerformancePayload":{"type":"object","properties":{"webSurface":{"$ref":"#/components/schemas/CreatorMetricsWebSurface"},"currentActiveSubscribers":{"anyOf":[{"type":"number"},{"type":"null"}]},"currentMonth":{"$ref":"#/components/schemas/CreatorPerformanceRow"},"history":{"type":"array","items":{"$ref":"#/components/schemas/CreatorPerformanceRow"}},"selectedMonthStart":{"type":"string"},"selectedMonth":{"$ref":"#/components/schemas/CreatorPerformanceRow"},"dailyHistory":{"type":"array","items":{"$ref":"#/components/schemas/CreatorDailyPerformanceRow"}},"gemSpendBreakdown":{"$ref":"#/components/schemas/CreatorGemSpendBreakdown"},"gemSpendEntries":{"type":"array","items":{"$ref":"#/components/schemas/CreatorGemSpendEntry"}},"gemSpendEntriesTotal":{"type":"number"},"gemSpendEntriesLimit":{"type":"number"},"gemSpendEntriesOffset":{"type":"number"},"gemSpendEntriesHasMore":{"type":"boolean"},"gemSpendEntriesNextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"gemSpendCategoryFilter":{"$ref":"#/components/schemas/CreatorGemSpendCategoryFilter"},"subscriptionPurchases":{"type":"array","items":{"$ref":"#/components/schemas/CreatorSubscriptionPurchaseEntry"}},"subscriptionPurchasesLimit":{"type":"number"},"subscriptionPurchasesHasMore":{"type":"boolean"},"subscriptionPurchasesNextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"topGemSpenders":{"type":"array","items":{"$ref":"#/components/schemas/CreatorTopGemSpender"}},"topPpvPosts":{"type":"array","items":{"$ref":"#/components/schemas/CreatorTopPpvPostPerformance"}},"topOffers":{"type":"array","items":{"$ref":"#/components/schemas/CreatorTopOfferPerformance"}},"activeSubscribers":{"type":"array","items":{"$ref":"#/components/schemas/CreatorActiveSubscriber"}},"activeSubscribersTotal":{"anyOf":[{"type":"number"},{"type":"null"}]},"activeSubscribersLimit":{"type":"number"},"activeSubscribersOffset":{"type":"number"},"activeSubscribersHasMore":{"type":"boolean"},"activeSubscribersNextCursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"payoutPeriodSummary":{"anyOf":[{"$ref":"#/components/schemas/CreatorPayoutPeriodSummary"},{"type":"null"}]}},"required":["currentActiveSubscribers","currentMonth","history","selectedMonthStart","selectedMonth","dailyHistory","gemSpendBreakdown","gemSpendEntries","gemSpendEntriesTotal","gemSpendEntriesLimit","gemSpendEntriesOffset","gemSpendCategoryFilter","subscriptionPurchases","subscriptionPurchasesLimit","subscriptionPurchasesHasMore","subscriptionPurchasesNextCursor","topGemSpenders","topPpvPosts","topOffers","activeSubscribers","activeSubscribersTotal","activeSubscribersLimit","activeSubscribersOffset","payoutPeriodSummary"],"additionalProperties":false},"CreatorPerformanceRow":{"type":"object","properties":{"month_start":{"type":"string"},"month_end":{"anyOf":[{"type":"string"},{"type":"null"}]},"subscriptions_received":{"type":"number"},"current_active_subscribers":{"anyOf":[{"type":"number"},{"type":"null"}]},"fulfilled_gems_received":{"type":"number"},"fan_messages_received":{"type":"number"},"computed_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["month_start","month_end","subscriptions_received","current_active_subscribers","fulfilled_gems_received","fan_messages_received","computed_at"],"additionalProperties":false},"CreatorDailyPerformanceRow":{"type":"object","properties":{"day_date":{"type":"string"},"subscriptions_received":{"type":"number"},"current_active_subscribers":{"anyOf":[{"type":"number"},{"type":"null"}]},"fulfilled_gems_received":{"type":"number"},"fan_messages_received":{"type":"number"},"computed_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["day_date","subscriptions_received","current_active_subscribers","fulfilled_gems_received","fan_messages_received","computed_at"],"additionalProperties":false},"CreatorGemSpendBreakdown":{"type":"object","properties":{"tips":{"type":"number"},"messages":{"type":"number"},"offers":{"type":"number"},"other":{"type":"number"}},"required":["tips","messages","offers","other"],"additionalProperties":false},"CreatorGemSpendEntry":{"type":"object","properties":{"id":{"type":"string"},"occurred_at":{"type":"string"},"spender_user_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"spender_conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"spender_username":{"anyOf":[{"type":"string"},{"type":"null"}]},"purpose":{"type":"string"},"category":{"$ref":"#/components/schemas/CreatorGemSpendCategory"},"context_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"context_label":{"anyOf":[{"type":"string"},{"type":"null"}]},"gems":{"type":"number"},"real_gem_half_units":{"type":"number"},"bonus_gem_half_units":{"type":"number"},"legacy_bonus_gem_half_units":{"type":"number"},"funding_basis":{"anyOf":[{"type":"string","const":"wallet"},{"type":"string","const":"legacy_performance_credit"},{"type":"string","const":"legacy_unclassified"}]},"status":{"type":"string"},"recovery":{"$ref":"#/components/schemas/CreatorRecoveryPresentation"},"earnings_eligibility":{"$ref":"#/components/schemas/CreatorEarningsEligibilityPresentation"}},"required":["id","occurred_at","spender_user_id","spender_conversation_id","spender_username","purpose","category","context_type","context_label","gems","real_gem_half_units","bonus_gem_half_units","legacy_bonus_gem_half_units","funding_basis","status","recovery","earnings_eligibility"],"additionalProperties":false},"CreatorGemSpendCategory":{"anyOf":[{"type":"string","const":"tips"},{"type":"string","const":"messages"},{"type":"string","const":"offers"},{"type":"string","const":"other"}]},"CreatorRecoveryPresentation":{"type":"object","properties":{"affected":{"type":"boolean"},"amount_cents":{"type":"number"},"source_kind":{"anyOf":[{"type":"string","const":"spend"},{"type":"string","const":"subscription"},{"type":"string","const":"sponsorship_policy_correction"},{"type":"null"}]},"reason_code":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["affected","amount_cents","source_kind","reason_code"],"additionalProperties":false},"CreatorEarningsEligibilityPresentation":{"type":"object","properties":{"eligible":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]},"snapshot_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"participation_policy":{"anyOf":[{"type":"string","const":"requires_monetized_soul"},{"type":"string","const":"independent_of_creator_plan"},{"type":"null"}]},"participation_policy_version":{"anyOf":[{"type":"number"},{"type":"null"}]},"correction_required":{"type":"boolean"},"correction_resolution":{"anyOf":[{"$ref":"#/components/schemas/SponsorshipIndependenceCorrectionResolution"},{"type":"null"}]}},"required":["eligible","reason","snapshot_id"],"additionalProperties":false},"CreatorGemSpendCategoryFilter":{"anyOf":[{"$ref":"#/components/schemas/CreatorGemSpendCategory"},{"type":"string","const":"all"}]},"CreatorSubscriptionPurchaseEntry":{"type":"object","properties":{"id":{"type":"string"},"occurred_at":{"type":"string"},"purchaser_user_id":{"type":"string"},"purchaser_conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"purchaser_username":{"anyOf":[{"type":"string"},{"type":"null"}]},"purchaser_display_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"amount_cents":{"type":"number"},"currency":{"type":"string"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}]},"recovery":{"$ref":"#/components/schemas/CreatorRecoveryPresentation"},"earnings_eligibility":{"$ref":"#/components/schemas/CreatorEarningsEligibilityPresentation"}},"required":["id","occurred_at","purchaser_user_id","purchaser_conversation_id","purchaser_username","purchaser_display_name","amount_cents","currency","provider","recovery","earnings_eligibility"],"additionalProperties":false},"CreatorTopGemSpender":{"type":"object","properties":{"spender_user_id":{"type":"string"},"spender_conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"spender_username":{"anyOf":[{"type":"string"},{"type":"null"}]},"spender_display_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"spender_image":{"anyOf":[{"type":"string"},{"type":"null"}]},"total_gems":{"type":"number"},"spend_count":{"type":"number"},"last_spend_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"breakdown":{"$ref":"#/components/schemas/CreatorGemSpendBreakdown"}},"required":["spender_user_id","spender_conversation_id","spender_username","spender_display_name","spender_image","total_gems","spend_count","last_spend_at","breakdown"],"additionalProperties":false},"CreatorTopPpvPostPerformance":{"type":"object","properties":{"post_id":{"type":"string"},"caption":{"anyOf":[{"type":"string"},{"type":"null"}]},"current_ppv_cost_gems":{"type":"number"},"total_gems":{"type":"number"},"purchase_count":{"type":"number"},"buyer_count":{"type":"number"},"last_purchased_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"post_created_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["post_id","caption","current_ppv_cost_gems","total_gems","purchase_count","buyer_count","last_purchased_at","post_created_at"],"additionalProperties":false},"CreatorTopOfferPerformance":{"type":"object","properties":{"offer_id":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"media_type":{"anyOf":[{"type":"string"},{"type":"null"}]},"source_cost_gems":{"type":"number"},"source_created_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"preview_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"cloudflare_image_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"mux_playback_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"total_gems":{"type":"number"},"purchase_count":{"type":"number"},"buyer_count":{"type":"number"},"reuse_purchase_count":{"type":"number"},"last_purchased_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["offer_id","description","media_type","source_cost_gems","source_created_at","preview_url","cloudflare_image_id","mux_playback_id","total_gems","purchase_count","buyer_count","reuse_purchase_count","last_purchased_at"],"additionalProperties":false},"CreatorActiveSubscriber":{"type":"object","properties":{"subscriber_user_id":{"type":"string"},"subscriber_conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"subscriber_username":{"anyOf":[{"type":"string"},{"type":"null"}]},"subscriber_display_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"subscriber_image":{"anyOf":[{"type":"string"},{"type":"null"}]},"access_grant_type":{"anyOf":[{"type":"string","const":"subscription"},{"type":"string","const":"soul_subscription"},{"type":"string","const":"free_until"},{"type":"string","const":"admin_grant"},{"type":"string","const":"promo"}]},"access_until":{"anyOf":[{"type":"string"},{"type":"null"}]},"subscription_status":{"anyOf":[{"type":"string"},{"type":"null"}]},"subscribed_at":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["subscriber_user_id","subscriber_conversation_id","subscriber_username","subscriber_display_name","subscriber_image","access_grant_type","access_until","subscription_status","subscribed_at"],"additionalProperties":false},"CreatorPayoutPeriodSummary":{"type":"object","properties":{"creator_id":{"type":"string"},"period_start":{"type":"string"},"period_end":{"type":"string"},"currency":{"type":"string","const":"USD"},"totals":{"$ref":"#/components/schemas/CreatorPayoutPeriodTotals"}},"required":["creator_id","period_start","period_end","currency","totals"],"additionalProperties":false},"CreatorPayoutPeriodTotals":{"type":"object","properties":{"performance_gems":{"type":"number"},"earnings_gems":{"type":"number"},"performance_value_cents":{"type":"number"},"earnings_value_cents":{"type":"number"},"bonus_value_cents":{"type":"number"},"platform_cost_cents":{"type":"number"},"gross_earnings_cents":{"type":"number"},"creator_profit_cents":{"type":"number"},"creator_net_profit_cents":{"type":"number"},"raw_creator_net_profit_cents":{"type":"number"},"recovery_liability_cents":{"type":"number"},"recovery_applied_cents":{"type":"number"},"outstanding_liability_cents":{"type":"number"},"effective_creator_net_profit_cents":{"type":"number"},"recovered":{"type":"boolean"},"reversed":{"type":"boolean"},"subscription_charge_cents":{"type":"number"},"subscription_transaction_fee_cents":{"type":"number"},"subscription_creator_net_profit_cents":{"type":"number"},"referral_bonus_cents":{"type":"number"},"remix_redemption_earnings_cents":{"type":"number"}},"required":["performance_gems","earnings_gems","performance_value_cents","earnings_value_cents","bonus_value_cents","platform_cost_cents","gross_earnings_cents","creator_profit_cents","creator_net_profit_cents","raw_creator_net_profit_cents","recovery_liability_cents","recovery_applied_cents","outstanding_liability_cents","effective_creator_net_profit_cents","recovered","reversed","subscription_charge_cents","subscription_transaction_fee_cents","subscription_creator_net_profit_cents","referral_bonus_cents","remix_redemption_earnings_cents"],"additionalProperties":false},"CreatorPerformanceGraph":{"type":"object","properties":{"entityId":{"type":"string"},"webSurface":{"$ref":"#/components/schemas/CreatorMetricsWebSurface"},"view":{"anyOf":[{"type":"string","const":"analytics"},{"type":"string","const":"earnings"}]},"period":{"$ref":"#/components/schemas/CreatorPerformanceGraphPeriod"},"start":{"type":"string"},"end":{"type":"string"},"granularity":{"anyOf":[{"type":"string","const":"hour"},{"type":"string","const":"day"}]},"earningsUnavailableReason":{"anyOf":[{"type":"string","const":"canonical_period_earnings_unavailable"},{"type":"null"}]},"points":{"type":"array","items":{"$ref":"#/components/schemas/CreatorPerformanceGraphPoint"}}},"required":["entityId","webSurface","view","period","start","end","granularity","earningsUnavailableReason","points"],"additionalProperties":false},"CreatorPerformanceGraphPeriod":{"anyOf":[{"type":"string","const":"day"},{"type":"string","const":"week"},{"type":"string","const":"month"},{"type":"string","const":"year"}]},"CreatorPerformanceGraphPoint":{"type":"object","properties":{"at":{"type":"string"},"subscriptions_received":{"anyOf":[{"type":"number"},{"type":"null"}]},"current_active_subscribers":{"anyOf":[{"type":"number"},{"type":"null"}]},"fulfilled_gems_received":{"anyOf":[{"type":"number"},{"type":"null"}]},"fan_messages_received":{"anyOf":[{"type":"number"},{"type":"null"}]},"creator_net_profit_cents":{"anyOf":[{"type":"number"},{"type":"null"}]},"referral_bonus_cents":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["at","subscriptions_received","current_active_subscribers","fulfilled_gems_received","fan_messages_received","creator_net_profit_cents","referral_bonus_cents"],"additionalProperties":false},"accountSoulSettingsSchema":{"type":"object","properties":{"schemaVersion":{"type":"number","const":1},"entityId":{"type":"string","format":"uuid"},"surface":{"type":"string","enum":["nsfw-disabled","nsfw-enabled"]},"profile":{"type":"object","properties":{"handle":{"type":"string"},"displayName":{"type":"string"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string"},"webSurfaceVisibility":{"anyOf":[{"type":"string","enum":["com","red","both"]},{"type":"null"}]},"identityBasicsLocked":{"type":"boolean"},"identityLocked":{"type":"boolean"},"identitySetupComplete":{"type":"boolean"},"remixSourceShareBasisPoints":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]}},"required":["handle","displayName","bio","status","webSurfaceVisibility","identityBasicsLocked","identityLocked","identitySetupComplete","remixSourceShareBasisPoints"],"additionalProperties":false},"automation":{"anyOf":[{"type":"object","properties":{"enableAutomatedResponsesOffers":{"type":"boolean"},"enableAudioMessageGeneration":{"type":"boolean"},"enableVisualOfferGeneration":{"type":"boolean"},"enablePrivateAssetManagement":{"type":"boolean"},"enableSponsorshipRequests":{"type":"boolean"},"enableGemSpend":{"type":"boolean"}},"required":["enableAutomatedResponsesOffers","enableAudioMessageGeneration","enableVisualOfferGeneration","enablePrivateAssetManagement","enableSponsorshipRequests","enableGemSpend"],"additionalProperties":false},{"type":"null"}]},"nsfwCreationMode":{"anyOf":[{"type":"string","enum":["never","only_in_messages","always"]},{"type":"null"}]},"likeness":{"type":"object","properties":{"consumerPolicy":{"type":"string","enum":["only_me","mutuals","everyone"]}},"required":["consumerPolicy"],"additionalProperties":false},"subscription":{"type":"object","properties":{"priceCents":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}]},"planPriceId":{"anyOf":[{"type":"string"},{"type":"null"}]},"discountAudience":{"anyOf":[{"type":"string","enum":["all","referred","none"]},{"type":"null"}]},"discountVersion":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}]}},"required":["priceCents","planPriceId","discountAudience","discountVersion"],"additionalProperties":false},"offerPrices":{"anyOf":[{"type":"object","properties":{"image":{"type":"object","properties":{"valueCents":{"type":"number","minimum":0},"visibleGems":{"type":"number","minimum":0},"gemValueVersionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"pricePolicyVersionId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["valueCents","visibleGems","gemValueVersionId","pricePolicyVersionId"],"additionalProperties":false},"video":{"type":"object","properties":{"valueCents":{"type":"number","minimum":0},"visibleGems":{"type":"number","minimum":0},"gemValueVersionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"pricePolicyVersionId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["valueCents","visibleGems","gemValueVersionId","pricePolicyVersionId"],"additionalProperties":false}},"required":["image","video"],"additionalProperties":false},{"type":"null"}]},"generationPriceBounds":{"type":"object","properties":{"image":{"type":"object","properties":{"minValueCents":{"type":"number","minimum":0},"maxValueCents":{"type":"number","minimum":0},"minVisibleGems":{"type":"number","minimum":0},"maxVisibleGems":{"type":"number","minimum":0},"policyVersionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string","enum":["catalog","fallback"]}},"required":["minValueCents","maxValueCents","minVisibleGems","maxVisibleGems","policyVersionId","source"],"additionalProperties":false},"video":{"type":"object","properties":{"minValueCents":{"type":"number","minimum":0},"maxValueCents":{"type":"number","minimum":0},"minVisibleGems":{"type":"number","minimum":0},"maxVisibleGems":{"type":"number","minimum":0},"policyVersionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string","enum":["catalog","fallback"]}},"required":["minValueCents","maxValueCents","minVisibleGems","maxVisibleGems","policyVersionId","source"],"additionalProperties":false}},"required":["image","video"],"additionalProperties":false},"messageTerms":{"anyOf":[{"type":"object","properties":{"mode":{"type":"string","enum":["creator_funded","fan_paid"]},"configuredFanPriceValueCents":{"type":"number","minimum":0},"chargedFanPriceValueCents":{"type":"number","minimum":0},"fanPriceHalfGemUnits":{"type":"number","minimum":0},"version":{"type":"integer","minimum":0},"operationCostPolicyVersionId":{"type":"string"},"priceBoundsPolicyVersionId":{"type":"string"},"gemValueVersionId":{"type":"string"}},"required":["mode","configuredFanPriceValueCents","chargedFanPriceValueCents","fanPriceHalfGemUnits","version","operationCostPolicyVersionId","priceBoundsPolicyVersionId","gemValueVersionId"],"additionalProperties":false},{"type":"null"}]},"fanMessageBudget":{"anyOf":[{"type":"object","properties":{"enabled":{"type":"boolean"},"allocatedValueCents":{"type":"number","minimum":0},"availableValueCents":{"type":"number","minimum":0},"consumedValueCents":{"type":"number","minimum":0},"version":{"type":"integer","minimum":0}},"required":["enabled","allocatedValueCents","availableValueCents","consumedValueCents","version"],"additionalProperties":false},{"type":"null"}]},"nativeProfileAvailable":{"type":"boolean"},"automationMutation":{"type":"object","properties":{"fields":{"type":"array","items":{"type":"string","enum":["enableAutomatedResponsesOffers","enableAudioMessageGeneration","enableVisualOfferGeneration","enablePrivateAssetManagement","enableSponsorshipRequests"]}},"nativeCas":{"type":"boolean","const":false},"durableReplayJournal":{"type":"boolean","const":false}},"required":["fields","nativeCas","durableReplayJournal"],"additionalProperties":false}},"required":["schemaVersion","entityId","surface","profile","automation","nsfwCreationMode","likeness","subscription","offerPrices","generationPriceBounds","messageTerms","fanMessageBudget","nativeProfileAvailable","automationMutation"],"additionalProperties":false},"accountSoulAutomationInputSchema":{"type":"object","properties":{"entityId":{"type":"string","format":"uuid"},"enableAutomatedResponsesOffers":{"type":"boolean"},"enableAudioMessageGeneration":{"type":"boolean"},"enableVisualOfferGeneration":{"type":"boolean"},"enablePrivateAssetManagement":{"type":"boolean"},"enableSponsorshipRequests":{"type":"boolean"}},"required":["entityId"],"additionalProperties":false,"minProperties":2,"x-native-refinement":"At least one of five optional native automation booleans must be present with entityId"},"accountSoulAutomationReceiptSchema":{"type":"object","properties":{"kind":{"type":"string","const":"creator-automation-preferences"},"schemaVersion":{"type":"number","const":1},"accountId":{"type":"string","format":"uuid"},"entityId":{"type":"string","format":"uuid"},"preferences":{"type":"object","properties":{"enableAutomatedResponsesOffers":{"type":"boolean"},"enableAudioMessageGeneration":{"type":"boolean"},"enableVisualOfferGeneration":{"type":"boolean"},"enablePrivateAssetManagement":{"type":"boolean"},"enableSponsorshipRequests":{"type":"boolean"},"enableGemSpend":{"type":"boolean"}},"required":["enableAutomatedResponsesOffers","enableAudioMessageGeneration","enableVisualOfferGeneration","enablePrivateAssetManagement","enableSponsorshipRequests","enableGemSpend"],"additionalProperties":false}},"required":["kind","schemaVersion","accountId","entityId","preferences"],"additionalProperties":false},"CreatorMetricsWebSurface":{"type":"string","enum":["nsfw-disabled","nsfw-enabled"]},"ListAccountConversationsRequest":{"type":"object","additionalProperties":false,"properties":{"query":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","format":"uuid","maxLength":2048},"q":{"type":"string","maxLength":2048,"description":"Canonical normalization truncates normalized search to80 characters; nonempty normalized q with id is rejected400."},"cursor":{"type":"string","maxLength":512},"limit":{"type":"string","pattern":"^[0-9]+$","maxLength":2048,"description":"Canonical positive values clamp1..50; zero/invalid values default50."}}},"body":{"type":"object","additionalProperties":false,"properties":{}}}},"GetAccountUnreadMessageCountRequest":{"type":"object","additionalProperties":false,"properties":{"query":{"type":"object","additionalProperties":false,"properties":{}},"body":{"type":"object","additionalProperties":false,"properties":{}}}},"MarkAccountConversationReadRequest":{"type":"object","additionalProperties":false,"properties":{"query":{"type":"object","additionalProperties":false,"properties":{}},"body":{"type":"object","additionalProperties":false,"properties":{"conversationId":{"type":"string","format":"uuid"},"readThroughMessageId":{"type":"string","format":"uuid"},"reason":{"type":"string","description":"Optional diagnostic string only; no authority, owner enum or per-field bound."}},"required":["conversationId","readThroughMessageId"]}},"required":["body"]},"GetAccountCreatorPerformanceRequest":{"type":"object","additionalProperties":false,"properties":{"query":{"type":"object","additionalProperties":false,"required":["entityId"],"properties":{"entityId":{"type":"string","format":"uuid","maxLength":2048},"month":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-01$","description":"UTC first-of-month YYYY-MM-DD; omitted=currentmonth","maxLength":2048},"category":{"type":"string","enum":["all","tips","messages","offers","other"],"maxLength":2048},"limit":{"type":"string","pattern":"^[0-9]+$","description":"Integer query value; canonical loader clamps0..200. SDK may present integer then serialize to string; do not claim a new serverCAS/validation policy.","maxLength":2048},"gem_spend_cursor":{"type":"string","description":"Canonical opaque base64url cursor; native decoder binds actor/entity/surface/month/category and rejects invalid cursor","maxLength":2048},"subscription_purchase_limit":{"type":"string","pattern":"^[0-9]+$","description":"Integer query value; canonical loader clamps0..200. SDK may present integer then serialize to string; do not claim a new serverCAS/validation policy.","maxLength":2048},"subscription_purchase_cursor":{"type":"string","description":"Canonical opaque base64url cursor; native decoder binds actor/entity/surface/month/category and rejects invalid cursor","maxLength":2048},"subscriber_limit":{"type":"string","pattern":"^[0-9]+$","description":"Integer query value; canonical loader clamps0..100. SDK may present integer then serialize to string; do not claim a new serverCAS/validation policy.","maxLength":2048},"subscriber_cursor":{"type":"string","description":"Canonical opaque base64url cursor; native decoder binds actor/entity/surface/month/category and rejects invalid cursor","maxLength":2048}}},"body":{"type":"object","additionalProperties":false,"properties":{}}},"required":["query"]},"GetAccountCreatorPerformanceGraphRequest":{"type":"object","additionalProperties":false,"properties":{"query":{"type":"object","additionalProperties":false,"required":["entityId","period","start"],"properties":{"entityId":{"type":"string","format":"uuid","maxLength":2048},"period":{"type":"string","enum":["day","week","month","year"],"maxLength":2048},"start":{"type":"string","pattern":"^[0-9]{4}-[0-9]{2}-[0-9]{2}(?:T00:00:00(?:\\.000)?Z)?$","description":"Valid UTC calendar date; week Monday, month day1, year Jan1; canonical normalizeCreatorPerformanceGraphWindow rejects misalignment","maxLength":2048},"view":{"type":"string","enum":["analytics","earnings"],"default":"analytics","maxLength":2048}}},"body":{"type":"object","additionalProperties":false,"properties":{}}},"required":["query"]},"GetAccountSoulSettingsRequest":{"type":"object","additionalProperties":false,"properties":{"query":{"type":"object","properties":{"entityId":{"type":"string","format":"uuid","maxLength":2048}},"required":["entityId"],"additionalProperties":false},"body":{"type":"object","additionalProperties":false,"properties":{}}},"required":["query"]},"UpdateAccountSoulAutomationPreferencesRequest":{"type":"object","additionalProperties":false,"properties":{"query":{"type":"object","additionalProperties":false,"properties":{}},"body":{"$ref":"#/components/schemas/accountSoulAutomationInputSchema"}},"required":["body"]},"MessageSendBillingPreview":{"type":"object","properties":{"source":{"enum":["not_applicable","subscription_free_message","creator_budget","bonus_gems","real_gems"]},"affordable":{"type":"boolean"},"chargedVisibleGems":{"type":"number"},"visibleGemHalfUnits":{"anyOf":[{"type":"number"},{"type":"null"}]},"chargedValueCents":{"type":"number"},"fanPayableValueCents":{"anyOf":[{"type":"number"},{"type":"null"}]},"fanPayableHalfGemUnits":{"anyOf":[{"type":"number"},{"type":"null"}]},"freeMessagesRemaining":{"anyOf":[{"type":"number"},{"type":"null"}]},"freeMessagesTotal":{"anyOf":[{"type":"number"},{"type":"null"}]},"bonusMessageUnitsRemaining":{"anyOf":[{"type":"number"},{"type":"null"}]},"availableBoughtValueCents":{"type":"number"},"availableBonusValueCents":{"type":"number"},"resolvedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"expiresAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"payer":{"anyOf":[{"enum":["none","creator_budget","subscription_benefit","fan"]},{"type":"null"}]},"fanChargeState":{"anyOf":[{"enum":["free","paid"]},{"type":"null"}]},"policyVersionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"gemValueVersionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"creatorBudgetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"creatorBudgetVersion":{"anyOf":[{"type":"number"},{"type":"null"}]},"commercialTermsId":{"anyOf":[{"type":"string"},{"type":"null"}]},"commercialTermsVersion":{"anyOf":[{"type":"number"},{"type":"null"}]},"commercialTermsMode":{"anyOf":[{"enum":["creator_funded","fan_paid"]},{"type":"null"}]},"configuredFanPriceValueCents":{"anyOf":[{"type":"number"},{"type":"null"}]},"chargedFanPriceValueCents":{"anyOf":[{"type":"number"},{"type":"null"}]},"fanPriceHalfGemUnits":{"anyOf":[{"type":"number"},{"type":"null"}]},"effectiveMinValueCents":{"anyOf":[{"type":"number"},{"type":"null"}]},"effectiveMinHalfGemUnits":{"anyOf":[{"type":"number"},{"type":"null"}]},"maxValueCents":{"anyOf":[{"type":"number"},{"type":"null"}]},"maxHalfGemUnits":{"anyOf":[{"type":"number"},{"type":"null"}]},"operationCostValueCents":{"anyOf":[{"type":"number"},{"type":"null"}]},"operationCostPolicyVersionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"priceBoundsPolicyVersionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"centsPerGemSnapshot":{"anyOf":[{"type":"number"},{"type":"null"}]},"bonusEligible":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"bonusAllowancePolicyVersionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"dependencyFingerprint":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["source","affordable","chargedVisibleGems","chargedValueCents","freeMessagesRemaining","bonusMessageUnitsRemaining","availableBoughtValueCents","availableBonusValueCents"]},"MessageSendBillingExpectedTerms":{"type":"object","properties":{"source":{"enum":["not_applicable","subscription_free_message","creator_budget","bonus_gems","real_gems"]},"payer":{"enum":["none","creator_budget","subscription_benefit","fan"]},"fanChargeState":{"enum":["free","paid"]},"chargedVisibleGems":{"type":"number"},"visibleGemHalfUnits":{"anyOf":[{"type":"number"},{"type":"null"}]},"chargedValueCents":{"type":"number"},"resolvedAt":{"type":"string"},"expiresAt":{"type":"string"},"policyVersionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"gemValueVersionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"creatorBudgetId":{"anyOf":[{"type":"string"},{"type":"null"}]},"creatorBudgetVersion":{"anyOf":[{"type":"number"},{"type":"null"}]},"commercialTermsId":{"anyOf":[{"type":"string"},{"type":"null"}]},"commercialTermsVersion":{"anyOf":[{"type":"number"},{"type":"null"}]},"commercialTermsMode":{"anyOf":[{"enum":["creator_funded","fan_paid"]},{"type":"null"}]},"configuredFanPriceValueCents":{"anyOf":[{"type":"number"},{"type":"null"}]},"chargedFanPriceValueCents":{"anyOf":[{"type":"number"},{"type":"null"}]},"fanPriceHalfGemUnits":{"anyOf":[{"type":"number"},{"type":"null"}]},"effectiveMinValueCents":{"anyOf":[{"type":"number"},{"type":"null"}]},"effectiveMinHalfGemUnits":{"anyOf":[{"type":"number"},{"type":"null"}]},"maxValueCents":{"anyOf":[{"type":"number"},{"type":"null"}]},"maxHalfGemUnits":{"anyOf":[{"type":"number"},{"type":"null"}]},"operationCostValueCents":{"anyOf":[{"type":"number"},{"type":"null"}]},"operationCostPolicyVersionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"priceBoundsPolicyVersionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"centsPerGemSnapshot":{"anyOf":[{"type":"number"},{"type":"null"}]},"bonusEligible":{"anyOf":[{"type":"boolean"},{"type":"null"}]},"bonusAllowancePolicyVersionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"dependencyFingerprint":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["source","payer","fanChargeState","chargedVisibleGems","chargedValueCents","resolvedAt","expiresAt","policyVersionId","gemValueVersionId","creatorBudgetId","creatorBudgetVersion"]},"AccountMessagePricingOnlyResponse":{"type":"object","properties":{"beforeSendDisclosureEnabled":{"type":"boolean"},"nextMessageBilling":{"$ref":"#/components/schemas/MessageSendBillingPreview"},"pricingPolicyVersionId":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["beforeSendDisclosureEnabled","nextMessageBilling","pricingPolicyVersionId"]},"AccountSoulFundingQuote":{"type":"object","additionalProperties":false,"properties":{"actionId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"quoteId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"entityId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"webSurface":{"type":"string","enum":["nsfw-disabled","nsfw-enabled"]},"messageCount":{"type":"integer","minimum":1,"maximum":75000,"multipleOf":50},"configuredValueCents":{"type":"integer","minimum":1,"maximum":9007199254740991},"chargeValueCents":{"type":"integer","minimum":1,"maximum":9007199254740991},"visibleGems":{"type":"number","exclusiveMinimum":0},"visibleGemHalfUnits":{"type":"integer","minimum":1,"maximum":9007199254740991},"termsVersion":{"type":"integer","minimum":1,"maximum":9007199254740991},"budgetVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"operationCostValueCents":{"type":"integer","minimum":1,"maximum":9007199254740991},"operationCostPolicyVersionId":{"type":"string","minLength":1},"gemValueVersionId":{"type":"string","minLength":1},"gemValueVersion":{"type":"integer","minimum":1,"maximum":9007199254740991},"centsPerGemSnapshot":{"type":"number","exclusiveMinimum":0},"roundingPolicy":{"type":"object","additionalProperties":false,"properties":{"visible":{"type":"string","enum":["half_gem_ceil"]},"charge":{"type":"string","enum":["round_half_up","floor","ceil"]}},"required":["visible","charge"]},"resolvedAt":{"type":"string","description":"Native adapter requires a finite Date.parse value; no stronger timestamp formatting contract is added."},"expiresAt":{"type":"string","description":"Native adapter requires a finite Date.parse value; no stronger timestamp formatting contract is added."},"dependencyFingerprint":{"type":"string","minLength":1},"maxMessageCount":{"type":"integer","minimum":1,"maximum":75000,"multipleOf":50}},"required":["actionId","quoteId","entityId","webSurface","messageCount","configuredValueCents","chargeValueCents","visibleGems","visibleGemHalfUnits","termsVersion","budgetVersion","operationCostValueCents","operationCostPolicyVersionId","gemValueVersionId","gemValueVersion","centsPerGemSnapshot","roundingPolicy","resolvedAt","expiresAt","dependencyFingerprint","maxMessageCount"],"description":"Exact canonical quote; messageCount must not exceed maxMessageCount. Commit quote.actionId must equal the SAME Idempotency-Key UUID used for preparation, quote.entityId must equal normalized requested entityId. Native owner validates expiry/current prices/versions/fingerprint; no automatic acceptance."},"AccountSoulMessageBudgetSafe":{"type":"object","additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"},"entityId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"enabled":{"type":"boolean"},"allocatedValueCents":{"type":"integer","minimum":0,"maximum":9007199254740991},"availableValueCents":{"type":"integer","minimum":0,"maximum":9007199254740991},"consumedValueCents":{"type":"integer","minimum":0,"maximum":9007199254740991},"version":{"type":"integer","minimum":0,"maximum":9007199254740991},"gemValueVersionId":{"anyOf":[{"type":"string"},{"type":"null"}]},"centsPerGemSnapshot":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}]},"loadedRealBudgetCents":{"type":"integer","minimum":0,"maximum":9007199254740991},"loadedRealBudgetVisibleGems":{"type":"number","minimum":0},"minVisibleGems":{"type":"number","minimum":0},"maxVisibleGems":{"type":"number","minimum":0},"quoteVersion":{"type":"integer","minimum":0,"maximum":9007199254740991},"policyVersion":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]},"createdAt":{"anyOf":[{"type":"string","description":"Native adapter requires a finite Date.parse value; no stronger timestamp formatting contract is added."},{"type":"null"}]},"updatedAt":{"anyOf":[{"type":"string","description":"Native adapter requires a finite Date.parse value; no stronger timestamp formatting contract is added."},{"type":"null"}]}},"required":["id","entityId","enabled","allocatedValueCents","availableValueCents","consumedValueCents","version","gemValueVersionId","centsPerGemSnapshot","loadedRealBudgetCents","loadedRealBudgetVisibleGems","minVisibleGems","maxVisibleGems","quoteVersion","policyVersion","createdAt","updatedAt"]},"AccountSoulDiscountPolicy":{"type":"object","additionalProperties":false,"properties":{"entityId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"},"version":{"type":"number"},"discountAudience":{"type":"string","enum":["all","referred","none"]},"status":{"type":"string","enum":["active","retired","draft"]},"effectiveFrom":{"anyOf":[{"type":"string"},{"type":"null"}]},"effectiveTo":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["entityId","version","discountAudience","status","effectiveFrom","effectiveTo"]},"AccountSoulDiscountPreview":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["available","disabled","unavailable"]},"audience":{"type":"string","enum":["all","referred","none"]},"baseAmountCents":{"type":"number"},"discountedAmountCents":{"anyOf":[{"type":"number"},{"type":"null"}]},"currency":{"type":"string"},"intervalDays":{"type":"number"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["status","audience","baseAmountCents","discountedAmountCents","currency","intervalDays","reason"]},"AccountSoulEconomicMutationAcknowledgment":{"type":"object","additionalProperties":false,"properties":{"success":{"type":"boolean","const":true},"entityId":{"type":"string","pattern":"^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"}},"required":["success","entityId"]},"AccountSoulEconomicMutationOutcomeUnknown":{"type":"object","additionalProperties":false,"properties":{"error":{"const":"native_success_projection_unavailable","type":"string"},"outcome":{"const":"mutation_outcome_unknown","type":"string"},"reconciliationRequired":{"const":true,"type":"boolean"},"automaticRetryAllowed":{"const":false,"type":"boolean"}},"required":["error","outcome","reconciliationRequired","automaticRetryAllowed"]},"AccountSoulEconomicReadProjectionUnavailable":{"type":"object","additionalProperties":false,"properties":{"error":{"const":"native_success_projection_unavailable","type":"string"},"outcome":{"const":"read_projection_unavailable","type":"string"},"reconciliationRequired":{"const":false,"type":"boolean"},"automaticRetryAllowed":{"const":false,"type":"boolean"}},"required":["error","outcome","reconciliationRequired","automaticRetryAllowed"]},"UpdateAccountSoulGenerationPricesInput":{"type":"object","additionalProperties":false,"properties":{"entityId":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"},"contentOfferImagePriceGems":{"type":"integer","minimum":1,"maximum":9007199254740991},"contentOfferVideoPriceGems":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["entityId","contentOfferImagePriceGems","contentOfferVideoPriceGems"]},"UpdateAccountSoulSubscriptionPriceInput":{"type":"object","additionalProperties":false,"properties":{"entityId":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"},"subscriptionPriceCents":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["entityId","subscriptionPriceCents"]},"GetAccountSoulDiscountAudienceInput":{"type":"object","additionalProperties":false,"properties":{"entityId":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"},"baseAmountCents":{"type":"string","pattern":"^[0-9]+$","description":"If present must parse to a positive safe integer. Gateway string bound2048 applies."},"subscriptionPlanPriceId":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"}},"required":["entityId"]},"UpdateAccountSoulDiscountAudienceInput":{"type":"object","additionalProperties":false,"properties":{"entityId":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"},"discountAudience":{"type":"string","enum":["all","referred","none"]},"reason":{"type":"string"}},"required":["entityId","discountAudience"]},"UpdateAccountSoulMessageTermsInput":{"type":"object","additionalProperties":false,"properties":{"entityId":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"},"fanMessageCommercialTermsMode":{"type":"string","enum":["creator_funded","fan_paid"]},"fanMessagePriceHalfGemUnits":{"anyOf":[{"type":"integer","minimum":1,"maximum":9007199254740991},{"type":"null"}]},"fanMessageCommercialTermsExpectedVersion":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["entityId","fanMessageCommercialTermsMode"],"allOf":[{"if":{"properties":{"fanMessageCommercialTermsMode":{"const":"fan_paid"}}},"then":{"required":["fanMessagePriceHalfGemUnits"],"properties":{"fanMessagePriceHalfGemUnits":{"type":"integer","minimum":1,"maximum":9007199254740991}}}}]},"SetAccountSoulMessageBudgetEnabledInput":{"type":"object","additionalProperties":false,"properties":{"entityId":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"},"enableFanMessageBudget":{"type":"boolean"},"fanMessageBudgetExpectedVersion":{"anyOf":[{"type":"integer","minimum":0,"maximum":9007199254740991},{"type":"null"}]}},"required":["entityId","enableFanMessageBudget"]},"PrepareAccountSoulMessageBudgetInput":{"type":"object","additionalProperties":false,"properties":{"entityId":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"},"messageCount":{"type":"integer","minimum":1,"maximum":75000,"multipleOf":50}},"required":["entityId","messageCount"]},"CommitAccountSoulMessageBudgetInput":{"type":"object","additionalProperties":false,"properties":{"entityId":{"type":"string","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"},"quote":{"$ref":"#/components/schemas/AccountSoulFundingQuote"}},"required":["entityId","quote"]},"getAccountSoulLikenessPolicyInput":{"type":"object","properties":{"entityId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"}},"required":["entityId"],"additionalProperties":false},"updateAccountSoulLikenessPolicyInput":{"type":"object","properties":{"entityId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"},"consumerPolicy":{"type":"string","enum":["only_me","mutuals","everyone"]}},"required":["entityId","consumerPolicy"],"additionalProperties":false},"updateAccountSoulSurfaceVisibilityInput":{"type":"object","properties":{"entityId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"},"webSurfaceVisibility":{"type":"string","enum":["com","red","both"]},"expectedWebSurfaceVisibility":{"type":"string","enum":["com","red","both"]}},"required":["entityId","webSurfaceVisibility","expectedWebSurfaceVisibility"],"additionalProperties":false},"updateAccountSoulHandleInput":{"type":"object","properties":{"entityId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"},"profileHandle":{"type":"string","x-native-trim":true,"x-native-toLowerCase":true,"x-native-normalizedMaxLength":30,"description":"Server trims whitespace and lowercases, then enforces at most30 characters; raw input length is not independently bounded to30."},"expectedCurrentHandle":{"anyOf":[{"type":"string","maxLength":64},{"type":"null"}]},"publicHandlePolicyVersion":{"type":"number","const":3}},"required":["entityId","profileHandle","expectedCurrentHandle","publicHandlePolicyVersion"],"additionalProperties":false},"updateAccountSoulDisplayNameInput":{"type":"object","properties":{"entityId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"},"displayName":{"anyOf":[{"type":"string","x-native-trim":true,"x-native-normalizedMaxLength":15,"description":"Server trims whitespace, then enforces at most15 characters; nullable clear is accepted. Raw input length is not independently bounded to15."},{"type":"null"}]}},"required":["entityId","displayName"],"additionalProperties":false},"updateAccountSoulBioInput":{"type":"object","properties":{"entityId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"},"bio":{"anyOf":[{"type":"string","maxLength":16384},{"type":"null"}]}},"required":["entityId","bio"],"additionalProperties":false},"deleteAccountSoulInput":{"type":"object","properties":{"entityId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"},"actionId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"}},"required":["entityId","actionId"],"additionalProperties":false},"AccountSoulNonfinancialLikenessResponse":{"type":"object","properties":{"policy":{"type":"object","properties":{"entityId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"},"consumerPolicy":{"type":"string","enum":["only_me","mutuals","everyone"]}},"required":["entityId","consumerPolicy"],"additionalProperties":false}},"required":["policy"],"additionalProperties":false},"AccountSoulNonfinancialProfileResponse":{"type":"object","properties":{"entity":{"type":"object","properties":{"entityId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"},"handle":{"type":"string"},"displayName":{"type":"string"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string"},"webSurfaceVisibility":{"anyOf":[{"type":"string","enum":["com","red","both"]},{"type":"null"}]}},"required":["entityId","handle","displayName","bio","status","webSurfaceVisibility"],"additionalProperties":false}},"required":["entity"],"additionalProperties":false},"AccountSoulNonfinancialDisplayNameResponse":{"type":"object","properties":{"entityId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"},"updated":{"type":"boolean","const":true}},"required":["entityId","updated"],"additionalProperties":false},"AccountSoulNonfinancialBioResponse":{"type":"object","properties":{"entityId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"},"bio":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["entityId","bio"],"additionalProperties":false},"AccountSoulNonfinancialDeletionResponse":{"type":"object","properties":{"deletion":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"},"entityId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"},"state":{"type":"string","enum":["accepted","pending","completed","failed"]},"phase":{"type":"string","maxLength":256},"blockerCodes":{"type":"array","items":{"type":"string","maxLength":256},"maxItems":64},"nextTransitionAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"revision":{"type":"integer","exclusiveMinimum":0},"requestedAt":{"type":"string"},"finalizedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["requestId","entityId","state","phase","blockerCodes","nextTransitionAt","revision","requestedAt","finalizedAt"],"additionalProperties":false},"statusLookup":{"type":"object","properties":{"operationId":{"type":"string","const":"getAccountSoulDeletionStatus"},"query":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"},"entityId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"}},"required":["requestId","entityId"],"additionalProperties":false}},"required":["operationId","query"],"additionalProperties":false},"terminal":{"type":"boolean"}},"required":["deletion","statusLookup","terminal"],"additionalProperties":false},"AccountSoulMutationOutcomeUnknown":{"type":"object","properties":{"error":{"type":"string","const":"native_success_projection_unavailable"},"outcome":{"type":"string","const":"mutation_outcome_unknown"},"nativeStatus":{"type":"integer","minimum":200,"maximum":299},"reconciliationRequired":{"type":"boolean","const":true},"automaticRetryAllowed":{"type":"boolean","const":false}},"required":["error","outcome","nativeStatus","reconciliationRequired","automaticRetryAllowed"],"additionalProperties":false},"AccountSoulDeletionStatusQuery":{"type":"object","properties":{"entityId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"},"requestId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"}},"required":["entityId","requestId"],"additionalProperties":false},"AccountSoulDeletionStatusResponse":{"type":"object","properties":{"deletion":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"},"entityId":{"type":"string","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","x-native-normalization":"validated UUID lowercase; no trim/fallback"},"state":{"type":"string","enum":["accepted","pending","completed","failed"]},"phase":{"type":"string","maxLength":256},"blockerCodes":{"type":"array","items":{"type":"string","maxLength":256},"maxItems":64},"nextTransitionAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"revision":{"type":"integer","exclusiveMinimum":0},"requestedAt":{"type":"string"},"finalizedAt":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["requestId","entityId","state","phase","blockerCodes","nextTransitionAt","revision","requestedAt","finalizedAt"],"additionalProperties":false}},"required":["deletion"],"additionalProperties":false},"UpdateAccountSoulGenerationPricesRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"$ref":"#/components/schemas/UpdateAccountSoulGenerationPricesInput"}},"required":["body"]},"UpdateAccountSoulSubscriptionPriceRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"$ref":"#/components/schemas/UpdateAccountSoulSubscriptionPriceInput"}},"required":["body"]},"GetAccountSoulDiscountAudienceRequest":{"type":"object","additionalProperties":false,"properties":{"query":{"$ref":"#/components/schemas/GetAccountSoulDiscountAudienceInput"}},"required":["query"]},"UpdateAccountSoulDiscountAudienceRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"$ref":"#/components/schemas/UpdateAccountSoulDiscountAudienceInput"}},"required":["body"]},"UpdateAccountSoulMessageTermsRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"$ref":"#/components/schemas/UpdateAccountSoulMessageTermsInput"}},"required":["body"]},"SetAccountSoulMessageBudgetEnabledRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"$ref":"#/components/schemas/SetAccountSoulMessageBudgetEnabledInput"}},"required":["body"]},"PrepareAccountSoulMessageBudgetRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"$ref":"#/components/schemas/PrepareAccountSoulMessageBudgetInput"}},"required":["body"]},"CommitAccountSoulMessageBudgetRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"$ref":"#/components/schemas/CommitAccountSoulMessageBudgetInput"}},"required":["body"]},"GetAccountSoulLikenessPolicyRequest":{"type":"object","additionalProperties":false,"properties":{"query":{"$ref":"#/components/schemas/getAccountSoulLikenessPolicyInput"}},"required":["query"]},"UpdateAccountSoulLikenessPolicyRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"$ref":"#/components/schemas/updateAccountSoulLikenessPolicyInput"}},"required":["body"]},"UpdateAccountSoulSurfaceVisibilityRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"$ref":"#/components/schemas/updateAccountSoulSurfaceVisibilityInput"}},"required":["body"]},"UpdateAccountSoulHandleRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"$ref":"#/components/schemas/updateAccountSoulHandleInput"}},"required":["body"]},"UpdateAccountSoulDisplayNameRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"$ref":"#/components/schemas/updateAccountSoulDisplayNameInput"}},"required":["body"]},"UpdateAccountSoulBioRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"$ref":"#/components/schemas/updateAccountSoulBioInput"}},"required":["body"]},"DeleteAccountSoulRequest":{"type":"object","additionalProperties":false,"properties":{"body":{"$ref":"#/components/schemas/deleteAccountSoulInput"}},"required":["body"]},"GetAccountSoulDeletionStatusRequest":{"type":"object","additionalProperties":false,"properties":{"query":{"$ref":"#/components/schemas/AccountSoulDeletionStatusQuery"}},"required":["query"]}}}}