Klineo/Docs
Open app ↗

API reference

Decision packs

Paths on this page are relative to /api/liquidity-studio/v2. Authentication and required headers vary by operation.

API reference overview · OpenAPI download

Operations on this page#

Method Path Operation
POST /decision-packs/from-treasury createTreasuryDecisionPack
POST /decision-packs/from-research createResearchDecisionPack
GET /decision-packs listDecisionPacks
POST /decision-packs createDecisionPack
GET /decision-packs/{packId} getDecisionPack
GET /decision-packs/{packId}/versions listDecisionPackVersions
GET /decision-packs/{packId}/versions/{sequence} getDecisionPackVersion
POST /decision-packs/{packId}/commands applyDecisionPackCommand

Prepare a private historical treasury scenario review with its exact project evidence#

POST /decision-packs/from-treasury

Operation ID: createTreasuryDecisionPack

Authentication: __Host-klineo_session cookie (sessionCookie)

Interactive current workspace members only. Private versioned public-evidence, Research-candidate or historical treasury-scenario review artifact; no Safe approval, finalized outcome, issuer verification, paid entitlement or publication authority. Supporting Health evidence may answer a different question, shown explicitly. Research candidates retain exact private trial references and one selected capital variant across scenarios. The project association is user-selected context, not verified issuer or quote identity. Completed candidate Review receipts can attach to matching Research candidate content under current source checks, without changing human decision or financial authority. Content edits clear the attachment in the new version while retaining immutable history. Treasury scenario packs bind an exact saved projection and historical project-control evidence without requiring Health or Research. Public drafts can be promoted to a treasury scenario pack; Research packs cannot yet attach treasury context because Candidate Review covers a different evidence scope. Treasury readiness is human review of historical declared assumptions, not current cash verification. Commercial-order references remain unsupported. Historical versions do not establish current project applicability.

Parameters#

Name Location Required Type Description and constraints
x-klineo-organization-id header Yes string —
Idempotency-Key header Yes string Pattern: ^[\x21-\x7E]+$; Min length: 8; Max length: 200

Request body#

Required: yes.

application/json

CreateTreasuryDecisionPack

Responses#

Status Description Content type and schema
200 Authorized immutable artifact, collection or exact command receipt. application/json: object
400 Invalid closed request or collection parameters. application/json: object
401 Interactive session required. application/json: object
403 Current membership or role denied; service credentials are not accepted. application/json: object
404 Record unavailable in this workspace. application/json: object
409 Command identity conflicts or lifecycle prerequisite not met. application/json: object
412 Reviewed project or pack version changed. application/json: object
429 Request limit exceeded. application/json: object
503 Storage or response verification unavailable. application/json: object

200 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —
ETag Yes string Pattern: ^"0x[0-9a-f]{64}"$

200 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
data Yes DecisionPackWriteReceipt —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

400 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

400 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

401 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

401 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

403 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

403 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

404 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

404 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

409 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

409 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

412 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

412 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

429 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

429 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

503 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

503 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

Prepare a private review candidate from an exact Research result#

POST /decision-packs/from-research

Operation ID: createResearchDecisionPack

Authentication: __Host-klineo_session cookie (sessionCookie)

Interactive current workspace members only. Private versioned public-evidence, Research-candidate or historical treasury-scenario review artifact; no Safe approval, finalized outcome, issuer verification, paid entitlement or publication authority. Supporting Health evidence may answer a different question, shown explicitly. Research candidates retain exact private trial references and one selected capital variant across scenarios. The project association is user-selected context, not verified issuer or quote identity. Completed candidate Review receipts can attach to matching Research candidate content under current source checks, without changing human decision or financial authority. Content edits clear the attachment in the new version while retaining immutable history. Treasury scenario packs bind an exact saved projection and historical project-control evidence without requiring Health or Research. Public drafts can be promoted to a treasury scenario pack; Research packs cannot yet attach treasury context because Candidate Review covers a different evidence scope. Treasury readiness is human review of historical declared assumptions, not current cash verification. Commercial-order references remain unsupported. Historical versions do not establish current project applicability.

Parameters#

Name Location Required Type Description and constraints
x-klineo-organization-id header Yes string —
Idempotency-Key header Yes string Pattern: ^[\x21-\x7E]+$; Min length: 8; Max length: 200

Request body#

Required: yes.

application/json

CreateResearchDecisionPack

Responses#

Status Description Content type and schema
200 Authorized immutable artifact, collection or exact command receipt. application/json: object
400 Invalid closed request or collection parameters. application/json: object
401 Interactive session required. application/json: object
403 Current membership or role denied; service credentials are not accepted. application/json: object
404 Record unavailable in this workspace. application/json: object
409 Command identity conflicts or lifecycle prerequisite not met. application/json: object
412 Reviewed project or pack version changed. application/json: object
429 Request limit exceeded. application/json: object
503 Storage or response verification unavailable. application/json: object

200 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —
ETag Yes string Pattern: ^"0x[0-9a-f]{64}"$

200 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
data Yes DecisionPackWriteReceipt —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

400 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

400 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

401 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

401 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

403 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

403 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

404 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

404 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

409 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

409 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

412 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

412 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

429 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

429 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

503 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

503 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

List private analysis Decision Packs#

GET /decision-packs

Operation ID: listDecisionPacks

Authentication: __Host-klineo_session cookie (sessionCookie)

Interactive current workspace members only. Private versioned public-evidence, Research-candidate or historical treasury-scenario review artifact; no Safe approval, finalized outcome, issuer verification, paid entitlement or publication authority. Supporting Health evidence may answer a different question, shown explicitly. Research candidates retain exact private trial references and one selected capital variant across scenarios. The project association is user-selected context, not verified issuer or quote identity. Completed candidate Review receipts can attach to matching Research candidate content under current source checks, without changing human decision or financial authority. Content edits clear the attachment in the new version while retaining immutable history. Treasury scenario packs bind an exact saved projection and historical project-control evidence without requiring Health or Research. Public drafts can be promoted to a treasury scenario pack; Research packs cannot yet attach treasury context because Candidate Review covers a different evidence scope. Treasury readiness is human review of historical declared assumptions, not current cash verification. Commercial-order references remain unsupported. Historical versions do not establish current project applicability.

Parameters#

Name Location Required Type Description and constraints
x-klineo-organization-id header Yes string —
cursor query No string Pattern: ^decisionpack_[a-f0-9]{32}$
limit query No integer Default: 20; Minimum: 1; Maximum: 20

Responses#

Status Description Content type and schema
200 Authorized immutable artifact, collection or exact command receipt. application/json: object
400 Invalid closed request or collection parameters. application/json: object
401 Interactive session required. application/json: object
403 Current membership or role denied; service credentials are not accepted. application/json: object
404 Record unavailable in this workspace. application/json: object
429 Request limit exceeded. application/json: object
503 Storage or response verification unavailable. application/json: object

200 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

200 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
data Yes DecisionPackList —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

400 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

400 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

401 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

401 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

403 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

403 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

404 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

404 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

429 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

429 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

503 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

503 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

Create a draft bound to a saved public-project observation#

POST /decision-packs

Operation ID: createDecisionPack

Authentication: __Host-klineo_session cookie (sessionCookie)

Interactive current workspace members only. Private versioned public-evidence, Research-candidate or historical treasury-scenario review artifact; no Safe approval, finalized outcome, issuer verification, paid entitlement or publication authority. Supporting Health evidence may answer a different question, shown explicitly. Research candidates retain exact private trial references and one selected capital variant across scenarios. The project association is user-selected context, not verified issuer or quote identity. Completed candidate Review receipts can attach to matching Research candidate content under current source checks, without changing human decision or financial authority. Content edits clear the attachment in the new version while retaining immutable history. Treasury scenario packs bind an exact saved projection and historical project-control evidence without requiring Health or Research. Public drafts can be promoted to a treasury scenario pack; Research packs cannot yet attach treasury context because Candidate Review covers a different evidence scope. Treasury readiness is human review of historical declared assumptions, not current cash verification. Commercial-order references remain unsupported. Historical versions do not establish current project applicability.

Parameters#

Name Location Required Type Description and constraints
x-klineo-organization-id header Yes string —
Idempotency-Key header Yes string Pattern: ^[\x21-\x7E]+$; Min length: 8; Max length: 200

Request body#

Required: yes.

application/json

CreateDecisionPack

Responses#

Status Description Content type and schema
200 Authorized immutable artifact, collection or exact command receipt. application/json: object
400 Invalid closed request or collection parameters. application/json: object
401 Interactive session required. application/json: object
403 Current membership or role denied; service credentials are not accepted. application/json: object
404 Record unavailable in this workspace. application/json: object
409 Command identity conflicts or lifecycle prerequisite not met. application/json: object
412 Reviewed project or pack version changed. application/json: object
429 Request limit exceeded. application/json: object
503 Storage or response verification unavailable. application/json: object

200 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —
ETag Yes string Pattern: ^"0x[0-9a-f]{64}"$

200 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
data Yes DecisionPackWriteReceipt —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

400 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

400 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

401 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

401 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

403 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

403 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

404 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

404 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

409 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

409 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

412 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

412 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

429 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

429 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

503 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

503 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

Read the latest Decision Pack version#

GET /decision-packs/{packId}

Operation ID: getDecisionPack

Authentication: __Host-klineo_session cookie (sessionCookie)

Interactive current workspace members only. Private versioned public-evidence, Research-candidate or historical treasury-scenario review artifact; no Safe approval, finalized outcome, issuer verification, paid entitlement or publication authority. Supporting Health evidence may answer a different question, shown explicitly. Research candidates retain exact private trial references and one selected capital variant across scenarios. The project association is user-selected context, not verified issuer or quote identity. Completed candidate Review receipts can attach to matching Research candidate content under current source checks, without changing human decision or financial authority. Content edits clear the attachment in the new version while retaining immutable history. Treasury scenario packs bind an exact saved projection and historical project-control evidence without requiring Health or Research. Public drafts can be promoted to a treasury scenario pack; Research packs cannot yet attach treasury context because Candidate Review covers a different evidence scope. Treasury readiness is human review of historical declared assumptions, not current cash verification. Commercial-order references remain unsupported. Historical versions do not establish current project applicability.

Parameters#

Name Location Required Type Description and constraints
x-klineo-organization-id header Yes string —
packId path Yes string Pattern: ^decisionpack_[a-f0-9]{32}$

Responses#

Status Description Content type and schema
200 Authorized immutable artifact, collection or exact command receipt. application/json: object
400 Invalid closed request or collection parameters. application/json: object
401 Interactive session required. application/json: object
403 Current membership or role denied; service credentials are not accepted. application/json: object
404 Record unavailable in this workspace. application/json: object
429 Request limit exceeded. application/json: object
503 Storage or response verification unavailable. application/json: object

200 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —
ETag Yes string Pattern: ^"0x[0-9a-f]{64}"$

200 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
data Yes DecisionPack —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

400 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

400 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

401 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

401 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

403 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

403 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

404 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

404 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

429 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

429 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

503 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

503 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

List immutable Decision Pack version metadata#

GET /decision-packs/{packId}/versions

Operation ID: listDecisionPackVersions

Authentication: __Host-klineo_session cookie (sessionCookie)

Interactive current workspace members only. Private versioned public-evidence, Research-candidate or historical treasury-scenario review artifact; no Safe approval, finalized outcome, issuer verification, paid entitlement or publication authority. Supporting Health evidence may answer a different question, shown explicitly. Research candidates retain exact private trial references and one selected capital variant across scenarios. The project association is user-selected context, not verified issuer or quote identity. Completed candidate Review receipts can attach to matching Research candidate content under current source checks, without changing human decision or financial authority. Content edits clear the attachment in the new version while retaining immutable history. Treasury scenario packs bind an exact saved projection and historical project-control evidence without requiring Health or Research. Public drafts can be promoted to a treasury scenario pack; Research packs cannot yet attach treasury context because Candidate Review covers a different evidence scope. Treasury readiness is human review of historical declared assumptions, not current cash verification. Commercial-order references remain unsupported. Historical versions do not establish current project applicability.

Parameters#

Name Location Required Type Description and constraints
x-klineo-organization-id header Yes string —
packId path Yes string Pattern: ^decisionpack_[a-f0-9]{32}$
cursor query No string Pattern: ^[1-9][0-9]{0,17}$
limit query No integer Default: 20; Minimum: 1; Maximum: 20

Responses#

Status Description Content type and schema
200 Authorized immutable artifact, collection or exact command receipt. application/json: object
400 Invalid closed request or collection parameters. application/json: object
401 Interactive session required. application/json: object
403 Current membership or role denied; service credentials are not accepted. application/json: object
404 Record unavailable in this workspace. application/json: object
429 Request limit exceeded. application/json: object
503 Storage or response verification unavailable. application/json: object

200 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

200 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
data Yes DecisionPackHistory —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

400 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

400 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

401 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

401 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

403 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

403 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

404 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

404 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

429 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

429 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

503 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

503 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

Read an exact historical Decision Pack version#

GET /decision-packs/{packId}/versions/{sequence}

Operation ID: getDecisionPackVersion

Authentication: __Host-klineo_session cookie (sessionCookie)

Interactive current workspace members only. Private versioned public-evidence, Research-candidate or historical treasury-scenario review artifact; no Safe approval, finalized outcome, issuer verification, paid entitlement or publication authority. Supporting Health evidence may answer a different question, shown explicitly. Research candidates retain exact private trial references and one selected capital variant across scenarios. The project association is user-selected context, not verified issuer or quote identity. Completed candidate Review receipts can attach to matching Research candidate content under current source checks, without changing human decision or financial authority. Content edits clear the attachment in the new version while retaining immutable history. Treasury scenario packs bind an exact saved projection and historical project-control evidence without requiring Health or Research. Public drafts can be promoted to a treasury scenario pack; Research packs cannot yet attach treasury context because Candidate Review covers a different evidence scope. Treasury readiness is human review of historical declared assumptions, not current cash verification. Commercial-order references remain unsupported. Historical versions do not establish current project applicability.

Parameters#

Name Location Required Type Description and constraints
x-klineo-organization-id header Yes string —
packId path Yes string Pattern: ^decisionpack_[a-f0-9]{32}$
sequence path Yes string Pattern: ^[1-9][0-9]{0,17}$

Responses#

Status Description Content type and schema
200 Authorized immutable artifact, collection or exact command receipt. application/json: object
400 Invalid closed request or collection parameters. application/json: object
401 Interactive session required. application/json: object
403 Current membership or role denied; service credentials are not accepted. application/json: object
404 Record unavailable in this workspace. application/json: object
429 Request limit exceeded. application/json: object
503 Storage or response verification unavailable. application/json: object

200 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —
ETag Yes string Pattern: ^"0x[0-9a-f]{64}"$

200 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
data Yes DecisionPack —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

400 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

400 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

401 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

401 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

403 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

403 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

404 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

404 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

429 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

429 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

503 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

503 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

Append a versioned human review action to an exact pack version#

POST /decision-packs/{packId}/commands

Operation ID: applyDecisionPackCommand

Authentication: __Host-klineo_session cookie (sessionCookie)

Interactive current workspace members only. Private versioned public-evidence, Research-candidate or historical treasury-scenario review artifact; no Safe approval, finalized outcome, issuer verification, paid entitlement or publication authority. Supporting Health evidence may answer a different question, shown explicitly. Research candidates retain exact private trial references and one selected capital variant across scenarios. The project association is user-selected context, not verified issuer or quote identity. Completed candidate Review receipts can attach to matching Research candidate content under current source checks, without changing human decision or financial authority. Content edits clear the attachment in the new version while retaining immutable history. Treasury scenario packs bind an exact saved projection and historical project-control evidence without requiring Health or Research. Public drafts can be promoted to a treasury scenario pack; Research packs cannot yet attach treasury context because Candidate Review covers a different evidence scope. Treasury readiness is human review of historical declared assumptions, not current cash verification. Commercial-order references remain unsupported. Historical versions do not establish current project applicability.

Parameters#

Name Location Required Type Description and constraints
x-klineo-organization-id header Yes string —
packId path Yes string Pattern: ^decisionpack_[a-f0-9]{32}$
Idempotency-Key header Yes string Pattern: ^[\x21-\x7E]+$; Min length: 8; Max length: 200
If-Match header Yes string Pattern: ^"0x[0-9a-f]{64}"$

Request body#

Required: yes.

application/json

DecisionPackCommand

Responses#

Status Description Content type and schema
200 Authorized immutable artifact, collection or exact command receipt. application/json: object
400 Invalid closed request or collection parameters. application/json: object
401 Interactive session required. application/json: object
403 Current membership or role denied; service credentials are not accepted. application/json: object
404 Record unavailable in this workspace. application/json: object
409 Command identity conflicts or lifecycle prerequisite not met. application/json: object
412 Reviewed project or pack version changed. application/json: object
428 Strong current pack If-Match required. application/json: object
429 Request limit exceeded. application/json: object
503 Storage or response verification unavailable. application/json: object

200 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —
ETag Yes string Pattern: ^"0x[0-9a-f]{64}"$

200 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
data Yes DecisionPackWriteReceipt —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

400 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

400 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

401 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

401 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

403 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

403 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

404 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

404 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

409 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

409 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

412 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

412 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

428 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

428 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

429 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

429 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

503 response headers

Header Required Type Description and constraints
Cache-Control Yes Constant private, no-store —

503 application/json body

object — Additional properties rejected

Field Required at this level Type Description and constraints
error Yes ApiError —

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.