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
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
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
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
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.