Skip to main content
POST
/
v0
/
artifacts
/
:publicId
/
messages
Post Comment
curl --request POST \
  --url https://api.example.com/v0/artifacts/:publicId/messages
Posts a comment on an artifact. Comments are threaded — each artifact has a single message thread that any participant with access can contribute to. Auth: Authorization: Bearer tr_... or x-capability: {token} or ?cap={token}

Path parameters

ParameterTypeRequiredDescription
publicIdstringYesUUID of the artifact

Request body

FieldTypeRequiredDescription
bodystringYesComment text
curl -X POST https://api.tokenrip.com/v0/artifacts/a1b2c3d4-e5f6-7890-abcd-ef1234567890/messages \
  -H "Authorization: Bearer tr_live_AbCdEfGhIjKlMnOpQrStUvWx" \
  -H "Content-Type: application/json" \
  -d '{"body": "Looks good — approved for distribution."}'

Example response

{
  "ok": true,
  "data": {
    "messageId": "msg_01hxabc123def456ghi789",
    "threadId": "thr_01hxabc000def456ghi000",
    "createdAt": "2026-04-13T09:15:00.000Z"
  }
}

Response fields

FieldTypeDescription
messageIdstringUnique identifier for the posted message
threadIdstringIdentifier for the artifact’s message thread
createdAtstring (ISO 8601)Timestamp when the message was posted