Native tools

Create a compact native Clarity map for one decision.

Uses only user-confirmed options and signals. The result is deterministic, does not call a generative-AI model on Hemelion’s account, does not verify external facts, and does not unlock a complete paid website report.

post/api/public/clarity-map

Request

  • Base URL: https://www.hemelion.com
  • URL: https://www.hemelion.com/api/public/clarity-map
  • Auth: none required

Request body

subject_attestationtrue required

Assert only if the person has confirmed they are 18 or older, this is their own non-emergency situation, and the result will not be used for diagnosis, regulated advice, or a high-impact decision about another person. Ask them if you have not. Do not assert this on assumption.

scope_category'general_personal' | 'general_business' | 'emergency_safety' | 'health_or_mental_health' | 'legal' | 'regulated_finance' | 'high_impact_third_party' required

Required safety classification. Use general_personal or general_business only for ordinary decisions; choose the matching regulated or urgent category otherwise.

decisionstring required

One concrete decision stated in the user’s own words. Do not infer private facts.

optionsstring[] required

Two or three real options supplied or confirmed by the user.

prioritiesstring[] required

One to three priorities confirmed by the user.

current_preference_indexinteger nullable

Which option the user currently prefers, if any. Use a zero-based index that is less than options.length: only 0 or 1 with two options, and 0, 1, or 2 with three. Use null or omit when no option leads.

priority_leader_indexinteger nullable

Which option best fits the user’s stated priorities, if any. Use a zero-based index that is less than options.length: only 0 or 1 with two options, and 0, 1, or 2 with three. Use null or omit when no option leads.

evidence_leader_indexinteger nullable

Which option currently has the strongest comparable real-world evidence, if any. Use a zero-based index that is less than options.length: only 0 or 1 with two options, and 0, 1, or 2 with three. Use null or omit when no option leads.

reversibilitynumber required

How easy the first commitment is to reverse: 0 means very hard, 100 means very easy.

constraintsstring[]

Material constraints the user explicitly identified.

deadline'now' | 'weeks' | 'months' | 'later'

When the user needs to decide.

regret'committed_too_soon' | 'waited_too_long' | 'both_equal' | 'unclear'

The timing mistake the user is more concerned about.

risk_tolerancenumber

Current emotional tolerance for downside: 0 low, 100 high.

agencynumber

How much direct control the user has over the outcome: 0 little, 100 high.

social_pressurenumber

How strongly other people’s expectations affect the choice: 0 none, 100 high.

avoidancenumber

How much the user suspects delay is replacing decision progress: 0 none, 100 high.

evidence_reliabilitynumber

How representative and comparable the current evidence is: 0 weak, 100 strong.

testabilitynumber

How easily the options can be compared in a bounded real-world test: 0 hard, 100 easy.

safety_netnumber

How much financial or practical buffer absorbs a bad outcome: 0 none, 100 substantial.

exit_plannumber

How prepared the user’s exit is if the choice turns out wrong: 0 none, 100 ready.

decision_confidencenumber

How confident the user feels making this decision now: 0 not at all, 100 fully.

values_claritynumber

How clear the user is about what they actually want: 0 unclear, 100 clear.

immediate_leaningnumber

The user’s immediate, unconsidered leaning toward their preferred option: 0 none, 100 strong. Ask for a first reaction, not a reasoned one.

identity_alignmentnumber

How well the preferred option fits who the user wants to become: 0 poorly, 100 closely.

emotional_statenumber

How settled the user feels right now: 0 highly stressed, 100 calm. Needed for the rule that flags a strong leaning formed under stress.

past_similar_outcome'never' | 'yes_good' | 'yes_bad' | 'yes_mixed'

Whether the user has faced a similar decision before and how it turned out.

Response

Attributed compact Clarity result or an explicit outside-scope boundary.

oktrue required

Example response

{
  "result": {
    "methodVersion": "4.1.0"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.