Commit one data artifact to a resource

POST

/api/resources/{id}/artifacts

Maintainer:Not configured

OperationId:commit_artifact

The content payload is JSON, hashed and stored verbatim. The hash is the proof —
the ledger carries only the hash, never the bytes. Auth-gated: the caller must
have write standing on the owning resource.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

Committed artifact

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠410Record Gone

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/resources//artifacts' \
--header 'X-Temper-Surface;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "confidence": "tentative",
    "correlation_id": "807686c4-116c-44b3-a01c-b14b50e31bcc",
    "invocation_id": "9efe53a2-0f4e-415e-a218-b405e1367798",
    "model": "string",
    "persona": "string",
    "rationale": "string",
    "reasoning": "string",
    "content": null,
    "intent": "string",
    "kind": "string",
    "kind_owner": {
        "kb_profiles": "40c182ea-092e-42ca-bc42-392526e29115"
    },
    "precedence": 0,
    "supersedes": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ]
}'

Response Example

200 - Example 1

{
    "artifact": {
        "artifact_id": "b7bd6bbb-c7f1-4314-8742-2aeeeece9d12",
        "artifact_kind": "string",
        "content": null,
        "content_bytes": 0,
        "content_hash": "string",
        "created": "2019-08-24T14:15:22.123Z",
        "intent": "string",
        "is_folded": true,
        "kind_owner_id": "2e869737-5c94-4cfc-a307-e58756894693",
        "kind_owner_table": "string",
        "precedence": 0,
        "resource_id": "4d5215ed-38bb-48ed-879a-fdb9ca58522f",
        "shape_state": "string"
    },
    "artifact_id": "b7bd6bbb-c7f1-4314-8742-2aeeeece9d12",
    "uncompilable_shape_notice": "string"
}

Modified at 2026-10-25 23:49:46

Get a single artifact by ID under its owning resource

Get a single artifact by ID — the flat read.