ReviewsEntityManageResult reviews.entity-manage-result@1

Generated at from openvibe-contracts v0.53.0 and openvibe-sdk v0.11.0.

Version
1.0.0
Owner
reviews
Visibility
first-party
Status
active
Compatibility
backward
Schema
https://openvibe.network/contracts/reviews/entity-manage-result.v1.json

reviews.entity-manage-result@1: answers of reviews.entity.manage on OpenVibe.Reviews. POST /api/v1/entities → 201 { entity, settled_items } (items the new aliases resolved); PATCH and DELETE /api/v1/entities/:ref → { entity }. POST …/aliases → 201 { alias, settled_items }; DELETE …/aliases/:id → { alias }. POST …/links → 201 { link }; DELETE …/links/:id → { link } (ended). POST /api/v1/trust → { scope, scope_id, key, current, affected_entities }. GET /api/v1/corrections → { corrections } (open, oldest first, with the entity row and whether its summary is published). PATCH /api/v1/corrections/:id → { correction, revision } (the correction revision when accepting corrected a published summary, else null). Row timestamps are epoch milliseconds.

Fields

This schema has no named fields.

Examples

From the contract's own test fixtures: valid ones validate, rejected ones must fail.

Valid: alias
{
  "alias": {
    "id": "als_01JAC4A5B6C7D8E9F0G1H2J3K4",
    "entity_id": "ent_01JAC1E2N3T4V5W6X7Y8Z9A0B1",
    "type": "sku",
    "value": "LX2-BLK",
    "norm": "LX2BLK",
    "created_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",
    "created_at": 1790241000000,
    "removed_at": null,
    "removed_by": null
  },
  "settled_items": 0
}
Valid: corrections
{
  "corrections": [
    {
      "id": "cor_01JAC7C8D9E0F1G2H3J4K5M6N7",
      "entity_id": "ent_01JAC1E2N3T4V5W6X7Y8Z9A0B1",
      "target_type": "aggregate",
      "target_id": null,
      "body": "The rating count looks doubled: Sound Lab lists 159 ratings.",
      "evidence_url": "https://soundlab.example/lumen-x2",
      "submitted_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",
      "via": null,
      "status": "open",
      "resolved_by": null,
      "resolution_note": null,
      "resolved_at": null,
      "created_at": 1790240000000,
      "entity": {
        "id": "ent_01JAC1E2N3T4V5W6X7Y8Z9A0B1",
        "slug": "lumen-x2-headphones",
        "name": "Lumen X2 Headphones",
        "kind": "product",
        "description": null,
        "state": "active",
        "merged_into": null,
        "noindex": 0,
        "created_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",
        "created_at": 1790237000000,
        "updated_at": 1790243000000,
        "deleted_at": null
      },
      "summary_published": true
    }
  ]
}
Valid: created
{
  "entity": {
    "id": "ent_01JAC1E2N3T4V5W6X7Y8Z9A0B1",
    "slug": "lumen-x2-headphones",
    "name": "Lumen X2 Headphones",
    "kind": "product",
    "description": null,
    "state": "active",
    "merged_into": null,
    "canonical_id": "ent_01JAC1E2N3T4V5W6X7Y8Z9A0B1",
    "noindex": false,
    "url": "https://openvibe.reviews/e/lumen-x2-headphones",
    "created_at": "2026-09-24T08:15:00.000Z",
    "updated_at": "2026-09-24T09:40:12.000Z"
  },
  "settled_items": 2
}
Valid: link
{
  "link": {
    "id": "lnk_01JAC5M6N7P8Q9R0S1T2V3W4X5",
    "from_entity": "ent_01JAC1E3N3T4V5W6X7Y8Z9A0B1",
    "to_entity": "ent_01JAC1E2N3T4V5W6X7Y8Z9A0B1",
    "type": "merged_into",
    "ref": null,
    "note": "Same headphones, regional name",
    "created_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",
    "created_at": 1790241000000,
    "ended_at": null,
    "ended_by": null,
    "end_note": null
  }
}
Valid: resolved
{
  "correction": {
    "id": "cor_01JAC7C8D9E0F1G2H3J4K5M6N7",
    "entity_id": "ent_01JAC1E2N3T4V5W6X7Y8Z9A0B1",
    "target_type": "aggregate",
    "target_id": null,
    "body": "The rating count looks doubled: Sound Lab lists 159 ratings.",
    "evidence_url": "https://soundlab.example/lumen-x2",
    "submitted_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",
    "via": null,
    "status": "accepted",
    "resolved_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",
    "resolution_note": "Checked against the source",
    "resolved_at": 1790244000000,
    "created_at": 1790240000000
  },
  "revision": {
    "number": 3,
    "status": "published",
    "overview": "Well-reviewed for comfort; battery life is the common complaint.",
    "points": [
      {
        "key": "overview",
        "kind": "overview",
        "text": null,
        "supported": true,
        "citations": [
          {
            "signal_id": "sig_01JAC2S3G4H5J6K7M8N9P0Q1R2",
            "ok": true,
            "status": "active",
            "in_entity": true,
            "superseded_by": null
          }
        ]
      },
      {
        "key": "pro:0",
        "kind": "pro",
        "text": "Comfortable over long sessions",
        "supported": true,
        "citations": [
          {
            "signal_id": "sig_01JAC2S4G4H5J6K7M8N9P0Q1R2",
            "ok": true,
            "status": "active",
            "in_entity": true,
            "superseded_by": null
          }
        ]
      }
    ],
    "authorship": {
      "mode": "human",
      "workflow": null,
      "stub_provider": false
    },
    "disclosure": null,
    "review": null,
    "system": null,
    "correction": {
      "note": "The rating count was doubled by an import error and has been fixed.",
      "corrects": 2,
      "requested": true
    },
    "author": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",
    "message": null,
    "created_at": "2026-09-24T09:40:12.000Z"
  }
}
Valid: trust
{
  "scope": "source",
  "scope_id": "sound-lab",
  "key": "aggregate",
  "current": {
    "id": 7,
    "scope": "source",
    "scope_id": "sound-lab",
    "key": "aggregate",
    "value": "exclude",
    "note": "Ratings include paid placements",
    "set_by": "usr_01JAB2C3D4E5F6G7H8J9K0MNPQ",
    "set_at": 1790242000000,
    "ended_at": null,
    "ended_by": null
  },
  "affected_entities": [
    "ent_01JAC1E2N3T4V5W6X7Y8Z9A0B1"
  ]
}
Valid: updated
{
  "entity": {
    "id": "ent_01JAC1E2N3T4V5W6X7Y8Z9A0B1",
    "slug": "lumen-x2-headphones",
    "name": "Lumen X2 Headphones",
    "kind": "product",
    "description": null,
    "state": "active",
    "merged_into": null,
    "canonical_id": "ent_01JAC1E2N3T4V5W6X7Y8Z9A0B1",
    "noindex": false,
    "url": "https://openvibe.reviews/e/lumen-x2-headphones",
    "created_at": "2026-09-24T08:15:00.000Z",
    "updated_at": "2026-09-24T09:40:12.000Z"
  }
}
Rejected: trust-without-current
{
  "scope": "source",
  "scope_id": "sound-lab",
  "key": "aggregate",
  "affected_entities": []
}

Validate

const contracts = require('openvibe-contracts');
contracts.validate('reviews.entity-manage-result@1', value);   // { valid, errors: [{ path, message }] }