Skip to content
Reference

Case Management Messages

These messages drive the lifecycle of a VulnerabilityCase, the record of one Coordinated Vulnerability Disclosure (CVD) case, and its roster of participants. They have no formal-protocol shorthand — the 28-symbol formal message set addresses state-machine transitions, not the case-infrastructure layer that supports them (see ADR-0083).

All messages on this page operate on a case that already exists. For the pre-existence bootstrap (vendor → case-actor service), see Case Proposal. For the ledger mechanism that replicates these activities to all participants, see Ledger Replication.

Two authorities appear below, and they are distinct roles rather than one actor. The Case Owner decides for the case: who is admitted, which roles they hold, and whether an ownership transfer is offered.

The CASE_MANAGER is the case's single-writer authority. It mints and updates the VulnerabilityCase object, records every case-scoped message in the ledger, and delivers case snapshots to participants (spec §10.1 Single-Writer Authority, ADR-0088). The CASE_MANAGER acts for the Case Owner. The same actor often holds both roles, but it need not.

If the CASE_MANAGER refuses one of these messages because a precondition does not hold, it answers the sender with the refusal notice. That notice is a Refuse of the refused message, with the reason in summary (CLP-02-005, CLP-05-001). The CASE_MANAGER records nothing of the refused message in the ledger. It sends no answer when the sender may not send the message at all, or when the message repeats one whose effect is already in place.

Each message on this page also states its sender's ledger position. The sender puts the tail of its copy of the case ledger in the activity's ledgerPosition, an object with logIndex and entryHash, when it builds the message (SYNC-18-001). A receiver refuses such a message when it carries no position or one that does not parse, and writes nothing (SYNC-18-015). Create(VulnerabilityCase), Update(VulnerabilityCase) and Announce(VulnerabilityCase) carry none, because the case they carry states its own position. A reply to a stub Invite carries none either, because its sender does not hold the case yet.

A refused Offer or Invite is answered with a Refuse of it, which the sender reads as a refusal, not as the decline of its request (ADR-0196). A refused close-case is answered with the same refusal notice. The 300-level introduction is The CASE_MANAGER and the Case Ledger.

Occasions

When… Send Send to Sent by Distinguished by Details
the CASE_MANAGER has opened a case for a submitted report Create(VulnerabilityCase) a participant the addressee of the case proposal or vulnerability report offer — Create case
the Case Owner links a further report to an existing case Add(VulnerabilityReport)[target=VulnerabilityCase] the CASE_MANAGER the Case Owner — Add report to case
the CASE_MANAGER records the new Case Owner once a case ownership transfer is accepted Update(VulnerabilityCase) a participant internal to the CASE_MANAGER — Update Case Owner
the CASE_MANAGER brings a vulnerability item into a case, such as one a new case takes from its CSAF report Add(VulnerabilityItem)[target=VulnerabilityCase] a participant internal to the CASE_MANAGER — Add vulnerability item to case
the CASE_MANAGER brings a case reference into a case, such as one a new case takes from its CSAF report Add(CaseReference)[target=VulnerabilityCase] a participant internal to the CASE_MANAGER — Add case reference to case
the Case Owner offers a CVD role on the case to another participant Offer(CaseParticipantRole)[context=VulnerabilityCase] the CASE_MANAGER the Case Owner — Offer case participant role
a participant accepts a role offered to it on the case Accept(Offer(CaseParticipantRole)[context=VulnerabilityCase]) the CASE_MANAGER the addressee of the case participant role offer — Accept case participant role
a participant declines a role offered to it on the case Reject(Offer(CaseParticipantRole)[context=VulnerabilityCase]) the CASE_MANAGER the addressee of the case participant role offer — Reject case participant role
the Case Owner proposes to transfer ownership of the case to another participant Offer(Offer(VulnerabilityCase)) the CASE_MANAGER the Case Owner — Propose case ownership transfer
the CASE_MANAGER offers the case to the actor the Case Owner proposed Offer(VulnerabilityCase) a participant the CASE_MANAGER — Offer case ownership transfer
an actor accepts an offer of case ownership Accept(Offer(VulnerabilityCase)) the CASE_MANAGER the addressee of the vulnerability case offer — Accept case ownership transfer
an actor declines an offer of case ownership Reject(Offer(VulnerabilityCase)) the CASE_MANAGER the addressee of the vulnerability case offer — Reject case ownership transfer
the Case Owner withdraws its proposal while the offer of case ownership is open Undo(Offer(Offer(VulnerabilityCase))) the CASE_MANAGER the Case Owner — Withdraw case ownership transfer
the CASE_MANAGER invites an actor to join the case Invite(VulnerabilityCase preview)[target=Actor] a participant the CASE_MANAGER — Invite actor to case
an invited actor agrees to join the case Accept(Invite(VulnerabilityCase preview)[target=Actor]) the CASE_MANAGER the invitee — Accept invite to case
an invited actor declines to join the case Reject(Invite(VulnerabilityCase preview)[target=Actor]) the CASE_MANAGER the invitee — Reject invite to case
the CASE_MANAGER has replayed the case ledger to a newly joined Participant Invite(whole VulnerabilityCase)[target=Actor] a participant the CASE_MANAGER — Send Full-Case Invite
a Participant asked by a Full-Case Invite judges the case valid Accept(Invite(whole VulnerabilityCase)[target=Actor]) the CASE_MANAGER the invitee — Accept Full-Case Invite
a Participant asked by a Full-Case Invite judges the case invalid TentativeReject(Invite(whole VulnerabilityCase)[target=Actor]) the CASE_MANAGER the invitee — Tentatively reject Full-Case Invite
a Participant asked by a Full-Case Invite closes the case Reject(Invite(whole VulnerabilityCase)[target=Actor]) the CASE_MANAGER the invitee — Reject Full-Case Invite
the CASE_MANAGER has admitted a new Participant to the case Announce(VulnerabilityCase) a participant the CASE_MANAGER — Announce vulnerability case
a Participant ends its participation in the case Leave(VulnerabilityCase) the CASE_MANAGER the Case Owner or a participant — Close case
the Case Owner reinstates a removed Participant Add(CaseParticipant)[target=VulnerabilityCase] the CASE_MANAGER the Case Owner — Add case participant to case
the Case Owner removes a Participant from active participation Remove(CaseParticipant)[target=VulnerabilityCase] the CASE_MANAGER the Case Owner — Remove case participant from case
the CASE_MANAGER creates a participant record, such as the inert record for the invitee of a stub Invite Create(CaseParticipant) a participant internal to the CASE_MANAGER — Create case participant
the CASE_MANAGER changes a participant record, such as moving the CASE_OWNER role on an ownership transfer Update(CaseParticipant) a participant internal to the CASE_MANAGER — Update case participant

Create case

Mints the vulnerability case, seats its initial participants and links the report.

  • When… the CASE_MANAGER has opened a case for a submitted report
  • Send: Create(VulnerabilityCase)
  • Send to: a participant
  • Sent by: the addressee of the case proposal or vulnerability report offer
  • Seen in: How to Initialize a Case
  • Mapping status: none
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Create",
  "id": "urn:uuid:9344e364-f6a8-4649-879c-5bacaa564cfb",
  "name": "https://vultron.example/organizations/vendorco Create VendorCo Case #20260602",
  "context": "https://demo.vultron.local/VulnerabilityReport/17a7b3e5-d74e-481e-ad90-2b9ab88c6dac",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "content": "We've created a case from this report.",
  "actor": "https://vultron.example/organizations/vendorco",
  "object": {
    "id": "https://demo.vultron.local/VulnerabilityCase/5db1ddf7-9f5e-4c09-b949-17bda2675110",
    "type": "VulnerabilityCase",
    "name": "VendorCo Case #20260602",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "attributedTo": "https://vultron.example/organizations/vendorco",
    "caseParticipants": [
      {
        "id": "urn:uuid:d5a50ba5-464f-441a-9825-eee7073c92cd",
        "type": "CaseParticipant",
        "name": "VendorCo",
        "published": "2026-06-01T19:12:00.000000+00:00",
        "updated": "2026-06-01T19:12:00.000000+00:00",
        "attributedTo": "https://vultron.example/organizations/vendorco",
        "caseRoles": [
          "vendor"
        ],
        "participantStatuses": [
          {
            "id": "urn:uuid:b05d5cb1-0576-4af3-b863-06c1edbfd008",
            "type": "ParticipantStatus",
            "name": "START vf",
            "context": "urn:uuid:d5a50ba5-464f-441a-9825-eee7073c92cd",
            "published": "2026-06-01T19:12:00.000000+00:00",
            "updated": "2026-06-01T19:12:00.000000+00:00",
            "attributedTo": "https://vultron.example/organizations/vendorco",
            "rmState": "START",
            "vfState": "vf",
            "caseEngagement": true,
            "cvdRole": [
              "VENDOR"
            ]
          }
        ],
        "embargoConsents": [],
        "joined": true
      }
    ],
    "actorParticipantIndex": {},
    "vulnerabilityReports": [
      {
        "id": "https://demo.vultron.local/VulnerabilityReport/17a7b3e5-d74e-481e-ad90-2b9ab88c6dac",
        "type": "VulnerabilityReport",
        "name": "FDR-8675309",
        "published": "2026-06-01T19:12:00.000000+00:00",
        "updated": "2026-06-01T19:12:00.000000+00:00",
        "content": "I found a vulnerability!",
        "attributedTo": "https://vultron.example/users/finndervul"
      }
    ],
    "vulnerabilityItems": [],
    "caseReferences": [],
    "caseStatuses": [
      {
        "id": "urn:uuid:14c9dcfe-a058-4a4b-a0da-e55de9630f5d",
        "type": "CaseStatus",
        "name": "NONE pxa",
        "context": "https://demo.vultron.local/VulnerabilityCase/5db1ddf7-9f5e-4c09-b949-17bda2675110",
        "published": "2026-06-01T19:12:00.000000+00:00",
        "attributedTo": "https://vultron.example/organizations/vendorco",
        "emState": "NONE",
        "pxaState": "pxa"
      }
    ],
    "notes": [],
    "embargoRegister": [],
    "pendingEmbargoProposalIndex": {},
    "caseActivity": [],
    "genesisHash": "e48fcedb51c3e594bd376174669eb8ba0bb7071caca46444ae05cb265ba39af1",
    "ledgerPosition": {
      "logIndex": -1,
      "entryHash": "e48fcedb51c3e594bd376174669eb8ba0bb7071caca46444ae05cb265ba39af1"
    },
    "parentCases": [],
    "childCases": [],
    "siblingCases": [],
    "activeParticipants": [
      "urn:uuid:d5a50ba5-464f-441a-9825-eee7073c92cd"
    ]
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/organizations/vendorco#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "zL6J5pmD53N377vGiqAErmGfXb9C4YduEUy2o4RhZq2YbnbJDT1QqGdp2nLUoc1psN7ZHmwz38aoe5mzmHsydMyd"
  }
}
  • Recipients: the CASE_MANAGER sends the completed case to the report receiver (the Case Owner) only (CBT-01-010, CM-22-006, CP-09-002). The report receiver then sends the report submitter a Create(VulnerabilityCase) as itself. That message names the CASE_MANAGER and is the trust bootstrap (spec §10.3 Case Bootstrap and the Trust Root; CBT-01-001, ADR-0132).
  • Who is named where: the actor of the Create is the CASE_MANAGER that mints the case, and the case's attributedTo is the Case Owner (CP-09-001, CP-09-011, CM-02-008). The two coincide when the Case Owner creates its own case, as in the example above. When a case-actor service creates the case from a Case Proposal, the service is the actor and attributedTo names the proposing actor, never the service itself. Every owner check reads attributedTo, and an ownership transfer rewrites it (CM-21-024).
  • Triggering transition: none — object construction precedes protocol state.
  • Example artifact: create_case.json.

Add report to case

Adds a vulnerability report to the case named by the target.

  • When… the Case Owner links a further report to an existing case
  • Send: Add(VulnerabilityReport)[target=VulnerabilityCase]
  • Send to: the CASE_MANAGER
  • Sent by: the Case Owner
  • Seen in: How to Initialize a Case
  • Mapping status: none
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Add",
  "id": "urn:uuid:21f4bfb2-5b99-48e3-8597-8cb42d3482ac",
  "name": "https://vultron.example/organizations/vendorco Add FDR-8675309 to urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "content": "We're adding this report to this case.",
  "actor": "https://vultron.example/organizations/vendorco",
  "target": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "object": {
    "id": "https://demo.vultron.local/VulnerabilityReport/17a7b3e5-d74e-481e-ad90-2b9ab88c6dac",
    "type": "VulnerabilityReport",
    "name": "FDR-8675309",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "content": "I found a vulnerability!",
    "attributedTo": "https://vultron.example/users/finndervul"
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/organizations/vendorco#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z3zziu5zS8N8cugfEHYhEqPfCNmTE4GLyhQh3wDPxCVy8b7jGSNPmc2hCsvUBXtAawPgYuBFDWfDxT4N4AZufvo4t"
  }
}
  • Triggering transition: none — a report can be added at any Report Management (RM) state.
  • Who may send: the CASE_MANAGER admits it only from the Case Owner, and a participant replica accepts it only from the CASE_MANAGER. Any other sender is refused and the report is not attached.
  • Example artifact: add_report_to_case.json.

Offer case participant role

Offers one role on the case to the participant named by the target. The CASE_MANAGER records the offer and forwards it to that participant.

  • When… the Case Owner offers a CVD role on the case to another participant
  • Send: Offer(CaseParticipantRole)[context=VulnerabilityCase]
  • Send to: the CASE_MANAGER
  • Sent by: the Case Owner
  • Seen in: How to Delegate a Role to Another Participant
  • Mapping status: none
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Offer",
  "id": "urn:uuid:cae6d509-a5f0-4fbd-98c1-955a2a8abaf8",
  "name": "https://vultron.example/organizations/vendorco Offer urn:uuid:60fbaa58-b92b-4a78-8efd-e407be78307a to Coordinator LLC",
  "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "content": "We're offering the coordinator role on case VendorCo Case #20260601 to Coordinator LLC.",
  "to": [
    "https://vultron.example/case-actors/vendorco-case-actor"
  ],
  "actor": "https://vultron.example/organizations/vendorco",
  "target": {
    "type": "Organization",
    "id": "https://vultron.example/organizations/coordinator",
    "name": "Coordinator LLC",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "inbox": {
      "id": "https://vultron.example/organizations/coordinator/inbox",
      "type": "OrderedCollection",
      "items": []
    },
    "outbox": {
      "id": "https://vultron.example/organizations/coordinator/outbox",
      "type": "OrderedCollection",
      "items": []
    }
  },
  "object": {
    "type": "CaseParticipantRole",
    "id": "urn:uuid:60fbaa58-b92b-4a78-8efd-e407be78307a",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "role": "coordinator"
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/organizations/vendorco#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z419PULstomDSjHmzH7XuUAmamiRer2BNdknjj7eVnDEEaKsEj3g7NBcCVMJ6b9n9rGt9bmZjXCSHJz4t39Sjtbgt"
  }
}
  • Routing: the offer is addressed to the CASE_MANAGER only, never to the target (CM-33-001). The CASE_MANAGER records it in the ledger (CM-33-007). Then it forwards it to the target as its own Offer(CaseParticipantRole), with the Case Owner in attributedTo and inReplyTo naming the recorded offer (CM-33-008). The target acts only on that forward, and answers the CASE_MANAGER, not the Case Owner (CM-33-004, CM-33-015). Nothing is granted until the CASE_MANAGER records the target's Accept (CM-02-016).
  • Who may send: the Case Owner only. The CASE_MANAGER refuses an offer from any other sender (CM-33-002). CASE_OWNER and CASE_MANAGER cannot be offered. The CASE_MANAGER also refuses an offer with no readable role, or of a role the target already holds. It also refuses an offer whose target is not a participant, or whose target is the CASE_MANAGER itself (CM-33-003). A refused offer is not recorded and not forwarded (CM-33-012, CM-33-013). The CASE_MANAGER answers an offer refused for its role or target with the refusal notice, and an offer from any other sender with nothing.
  • Object type: the object type alone identifies the activity as a role offer rather than an ownership-transfer offer (ADR-0039). Roles are granted through the case's authority chain (§12.1 Role Assignment).
  • Target: the participant offered the role. The context is the case.
  • Forward example: forward_case_participant_role.json.
  • Triggering transition: none — roster action, not a state-machine event.
  • Example artifact: offer_case_participant_role.json.

The CaseParticipantRole object carries the role. This offer is distinct from Offer(CaseParticipant), which forwards an actor recommendation to the Case Owner and is covered under Offer case participant.

Accept case participant role

Accepts the offered role. The participant holds the role once the CASE_MANAGER records the acceptance.

  • When… a participant accepts a role offered to it on the case
  • Send: Accept(Offer(CaseParticipantRole)[context=VulnerabilityCase])
  • Send to: the CASE_MANAGER
  • Sent by: the addressee of the case participant role offer
  • Seen in: How to Delegate a Role to Another Participant
  • Mapping status: none
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Accept",
  "id": "urn:uuid:2d6b2910-1d75-43ce-8129-b3612e4da80d",
  "name": "https://vultron.example/organizations/coordinator Accept https://vultron.example/case-actors/vendorco-case-actor Offer urn:uuid:c4c3fa84-54db-46a4-9e4a-3856de8fc8c7 to Coordinator LLC",
  "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "inReplyTo": "urn:uuid:eee54b5e-217a-4a9e-ab4e-d7747166fac1",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "content": "We're accepting the role you offered.",
  "to": [
    "https://vultron.example/case-actors/vendorco-case-actor"
  ],
  "actor": "https://vultron.example/organizations/coordinator",
  "object": {
    "type": "Offer",
    "id": "urn:uuid:eee54b5e-217a-4a9e-ab4e-d7747166fac1",
    "name": "https://vultron.example/case-actors/vendorco-case-actor Offer urn:uuid:c4c3fa84-54db-46a4-9e4a-3856de8fc8c7 to Coordinator LLC",
    "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
    "inReplyTo": "urn:uuid:3b279ee6-39f0-40c7-a7b4-6bfe42878d5e",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "content": "We're offering the coordinator role on case VendorCo Case #20260601 to Coordinator LLC.",
    "to": [
      "https://vultron.example/organizations/coordinator"
    ],
    "attributedTo": "https://vultron.example/organizations/vendorco",
    "actor": "https://vultron.example/case-actors/vendorco-case-actor",
    "target": {
      "type": "Organization",
      "id": "https://vultron.example/organizations/coordinator",
      "name": "Coordinator LLC",
      "published": "2026-06-01T19:12:00.000000+00:00",
      "updated": "2026-06-01T19:12:00.000000+00:00",
      "inbox": {
        "id": "https://vultron.example/organizations/coordinator/inbox",
        "type": "OrderedCollection",
        "items": []
      },
      "outbox": {
        "id": "https://vultron.example/organizations/coordinator/outbox",
        "type": "OrderedCollection",
        "items": []
      }
    },
    "object": {
      "type": "CaseParticipantRole",
      "id": "urn:uuid:c4c3fa84-54db-46a4-9e4a-3856de8fc8c7",
      "published": "2026-06-01T19:12:00.000000+00:00",
      "updated": "2026-06-01T19:12:00.000000+00:00",
      "role": "coordinator"
    }
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/organizations/coordinator#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "zihVm6aLLnkbFa3H4cLrRX2E1nqRn3ScxmmwjhpUgxobB84C9JWv3rcDz6ZWm8yJCWQLn2ZRQGorQkbWoL9HAjE8"
  }
}
  • Routing: the Accept goes to the CASE_MANAGER only, never to the Case Owner that made the offer (CM-33-015). Its object is the CASE_MANAGER's forward, which the CASE_MANAGER matches to the recorded offer through the forward's inReplyTo, never through the copy the Accept carries (CM-33-017).
  • Who may send: the target of the recorded offer only, and only while that offer is open: until the CASE_MANAGER records an Accept or Reject of it (CM-33-005). The CASE_MANAGER refuses an Accept from any other sender, or to an offer that is no longer open. It also refuses an Accept whose carried offer names another role or target. For a refused Accept, the CASE_MANAGER writes no ledger entry and changes no role (CM-33-016). When the CASE_MANAGER refuses an Accept because the offer is no longer open or its carried offer differs, it answers with the refusal notice. It answers an Accept from any other sender with nothing. A redelivery of the Accept that closed the offer changes nothing (CM-33-018).
  • Effect: the CASE_MANAGER records the Accept in the ledger as accept_case_participant_role, and grants the role on its own copy of the case. It announces the entry to every participant. Each participant grants the role when it replays the entry (CM-33-006, CM-33-019, CM-02-016, CM-02-020).
  • Triggering transition: none — roster action.
  • Example artifact: accept_case_participant_role.json.

Reject case participant role

Declines the offered role. The roster does not change.

  • When… a participant declines a role offered to it on the case
  • Send: Reject(Offer(CaseParticipantRole)[context=VulnerabilityCase])
  • Send to: the CASE_MANAGER
  • Sent by: the addressee of the case participant role offer
  • Seen in: How to Delegate a Role to Another Participant
  • Mapping status: none
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Reject",
  "id": "urn:uuid:c200fb78-2e1f-4e5c-8541-12bd0eff3527",
  "name": "https://vultron.example/organizations/coordinator Reject https://vultron.example/case-actors/vendorco-case-actor Offer urn:uuid:692fbb44-6130-4f02-a903-6dfa61218850 to Coordinator LLC",
  "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "inReplyTo": "urn:uuid:b5617700-2684-4d5a-9099-ecd350955ca8",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "content": "We're declining the role you offered.",
  "to": [
    "https://vultron.example/case-actors/vendorco-case-actor"
  ],
  "actor": "https://vultron.example/organizations/coordinator",
  "object": {
    "type": "Offer",
    "id": "urn:uuid:b5617700-2684-4d5a-9099-ecd350955ca8",
    "name": "https://vultron.example/case-actors/vendorco-case-actor Offer urn:uuid:692fbb44-6130-4f02-a903-6dfa61218850 to Coordinator LLC",
    "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
    "inReplyTo": "urn:uuid:c785fad4-5f01-4a31-8df9-57b79912c346",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "content": "We're offering the coordinator role on case VendorCo Case #20260601 to Coordinator LLC.",
    "to": [
      "https://vultron.example/organizations/coordinator"
    ],
    "attributedTo": "https://vultron.example/organizations/vendorco",
    "actor": "https://vultron.example/case-actors/vendorco-case-actor",
    "target": {
      "type": "Organization",
      "id": "https://vultron.example/organizations/coordinator",
      "name": "Coordinator LLC",
      "published": "2026-06-01T19:12:00.000000+00:00",
      "updated": "2026-06-01T19:12:00.000000+00:00",
      "inbox": {
        "id": "https://vultron.example/organizations/coordinator/inbox",
        "type": "OrderedCollection",
        "items": []
      },
      "outbox": {
        "id": "https://vultron.example/organizations/coordinator/outbox",
        "type": "OrderedCollection",
        "items": []
      }
    },
    "object": {
      "type": "CaseParticipantRole",
      "id": "urn:uuid:692fbb44-6130-4f02-a903-6dfa61218850",
      "published": "2026-06-01T19:12:00.000000+00:00",
      "updated": "2026-06-01T19:12:00.000000+00:00",
      "role": "coordinator"
    }
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/organizations/coordinator#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z4brzDaGuDzr4C8FBEY9TScCZ9x2ohyCJnQxp2uUyLzr8wBSKjpv5i1AR2VgVuosbbNLwRJH7Tz7R5np6pR1dpRaJ"
  }
}
  • Routing: as for the Accept, the Reject goes to the CASE_MANAGER only, and names the forward it answers (CM-33-015).
  • Who may send: as for the Accept, the target of the recorded offer only, while that offer is open (CM-33-005). The CASE_MANAGER answers a refused Reject as it does a refused Accept.
  • Effect: the CASE_MANAGER records the Reject in the ledger as reject_case_participant_role and announces the entry to every participant (CM-33-006, CM-33-019). The entry closes the offer, and no role changes (CM-33-021).
  • Triggering transition: none — roster action.
  • Example artifact: reject_case_participant_role.json.

The dedicated object type is preferred over a target-field discriminator (SE-08-003), and the earlier wire format Offer(VulnerabilityCase)[target=CaseParticipant] for offering a role has been removed.

Propose case ownership transfer

Asks the CASE_MANAGER to offer the case to another participant, for example from a Reporter to a Coordinator. The CASE_MANAGER offers the case only to an active participant, so the Case Owner invites any other actor first. The inner Offer names the case, the new owner as its target and, optionally, an endTime after which the CASE_MANAGER refuses an answer: the offer is then closed, with nothing recorded or sent. The CASE_MANAGER makes the offer itself.

  • When… the Case Owner proposes to transfer ownership of the case to another participant
  • Send: Offer(Offer(VulnerabilityCase))
  • Send to: the CASE_MANAGER
  • Sent by: the Case Owner
  • Mapping status: none
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Offer",
  "id": "urn:uuid:e37dd281-a585-442e-b817-23c07e556f20",
  "name": "https://vultron.example/organizations/vendorco Offer https://vultron.example/organizations/vendorco Offer urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a to https://vultron.example/organizations/coordinator",
  "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "content": "Please offer ownership of case VendorCo Case #20260601 to the coordinator.",
  "to": [
    "https://vultron.example/case-actors/vendorco-case-actor"
  ],
  "actor": "https://vultron.example/organizations/vendorco",
  "object": {
    "type": "Offer",
    "id": "urn:uuid:fd771189-5fc9-4e89-b211-a949b8d301e9",
    "name": "https://vultron.example/organizations/vendorco Offer urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a to https://vultron.example/organizations/coordinator",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "actor": "https://vultron.example/organizations/vendorco",
    "target": {
      "type": "Actor",
      "id": "https://vultron.example/organizations/coordinator"
    },
    "object": {
      "type": "VulnerabilityCase",
      "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a"
    }
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/organizations/vendorco#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z3PAqAMBXmHAdKXcFa7trwtXwowujhyn2EuipymYtB15Ti3GBCfw7UxqLyqcS1Aj9hRXHTwmWscX7ihoUyAvkEmyB"
  }
}
  • Routing: the proposal is addressed to the CASE_MANAGER, never to the proposed new owner (CM-21-005). See Case Ownership Transfer. The CASE_MANAGER admits it only from the Case Owner, and only while no offer for the case is open (CM-21-019, CM-21-014). It refuses a proposal whose inner offer names another case, or no actor it can address, and ignores any id, actor or to inside the inner offer.
  • Context: the case the proposal is about. The inner offer's object must be that case, as a typed reference: an inline object with only its id and type (AKM-03-004, ADR-0165).
  • Trigger: the Case Owner sends it with POST /actors/{actor_id}/trigger/offer-case-ownership-transfer, which returns the proposal (TRIG-11-001, Trigger API Reference).
  • Effect: the CASE_MANAGER records the proposal in the ledger and makes the offer below itself (ADR-0148).
  • Triggering transition: none — ownership transfer is a roster operation.
  • Example artifact: propose_case_ownership_transfer.json.

Offer case ownership transfer

Offers the case to the actor named by the target, on the Case Owner's behalf: attributedTo names the owner and inReplyTo the owner's proposal. This is the one offer of the transfer, the one the new owner accepts or rejects. It carries the proposal's endTime, if any.

  • When… the CASE_MANAGER offers the case to the actor the Case Owner proposed
  • Send: Offer(VulnerabilityCase)
  • Send to: a participant
  • Sent by: the CASE_MANAGER
  • Mapping status: none
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Offer",
  "id": "urn:uuid:4da5f431-774b-432b-8a7a-3d5e17956f01",
  "name": "https://vultron.example/case-actors/vendorco-case-actor Offer urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a to https://vultron.example/organizations/coordinator",
  "inReplyTo": "urn:uuid:1b0b761d-4f9d-4077-8774-5967d0aefbdd",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "content": "We're offering to transfer ownership of case VendorCo Case #20260601 to you.",
  "to": [
    "https://vultron.example/organizations/coordinator"
  ],
  "attributedTo": "https://vultron.example/organizations/vendorco",
  "actor": "https://vultron.example/case-actors/vendorco-case-actor",
  "target": {
    "type": "Actor",
    "id": "https://vultron.example/organizations/coordinator"
  },
  "object": {
    "type": "VulnerabilityCase",
    "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a"
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/case-actors/vendorco-case-actor#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z2tt9SLAmPYKBqpxi44DgNiEAbCNrDHKem3JQjKv11dUzCds6hMSGkk2HHjucMhP6jjBtbmsPgFmKHTPSma3PJJAS"
  }
}
  • Routing: the CASE_MANAGER makes the offer from the owner's proposal and records it in the ledger (§12.3 Case Ownership Transfer, CM-21-005). It is the one offer of the transfer: its id is one the CASE_MANAGER derives from the proposal, and the proposed new owner answers it by that id. A participant takes it only from the CASE_MANAGER (CM-21-019).
  • Target: the proposed new owner, as a full actor object.
  • Object: the case, as a typed reference: an inline object with only its id and type (AKM-03-004, ADR-0165). The proposed new owner is an active participant, so it already holds the case (CM-21-021).
  • Triggering transition: none — ownership transfer is a roster operation.
  • Example artifact: offer_case_ownership_transfer.json.

Accept case ownership transfer

Accepts the ownership transfer offer.

  • When… an actor accepts an offer of case ownership
  • Send: Accept(Offer(VulnerabilityCase))
  • Send to: the CASE_MANAGER
  • Sent by: the addressee of the vulnerability case offer
  • Mapping status: none
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Accept",
  "id": "urn:uuid:f5a84d51-d6a3-451f-85cd-4816a82a94d3",
  "name": "https://vultron.example/organizations/coordinator Accept https://vultron.example/case-actors/vendorco-case-actor Offer urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a to https://vultron.example/organizations/coordinator",
  "inReplyTo": "urn:uuid:e2879255-0a33-4785-9692-2e3f3c39b7fc",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "content": "We're accepting your offer to transfer ownership of case VendorCo Case #20260601 to us.",
  "actor": "https://vultron.example/organizations/coordinator",
  "object": {
    "type": "Offer",
    "id": "urn:uuid:e2879255-0a33-4785-9692-2e3f3c39b7fc",
    "name": "https://vultron.example/case-actors/vendorco-case-actor Offer urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a to https://vultron.example/organizations/coordinator",
    "inReplyTo": "urn:uuid:b8eeb483-9925-4114-8c88-db3125f739b8",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "content": "We're offering to transfer ownership of case VendorCo Case #20260601 to you.",
    "to": [
      "https://vultron.example/organizations/coordinator"
    ],
    "attributedTo": "https://vultron.example/organizations/vendorco",
    "actor": "https://vultron.example/case-actors/vendorco-case-actor",
    "target": {
      "type": "Actor",
      "id": "https://vultron.example/organizations/coordinator"
    },
    "object": {
      "type": "VulnerabilityCase",
      "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a"
    }
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/organizations/coordinator#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z3D2i8ftMw21qS2oyJnc2nTgv2CPvZXBo7HKidRaxskS2X6B2GWQ7QMDZG5fNseNQFA67ZHKwQzpEogh5mGK5t84j"
  }
}

Reject case ownership transfer

Declines the ownership transfer offer. The current Case Owner keeps the case.

  • When… an actor declines an offer of case ownership
  • Send: Reject(Offer(VulnerabilityCase))
  • Send to: the CASE_MANAGER
  • Sent by: the addressee of the vulnerability case offer
  • Mapping status: none
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Reject",
  "id": "urn:uuid:23c22b67-59af-4d58-8797-d9472b84f0dd",
  "name": "https://vultron.example/organizations/coordinator Reject https://vultron.example/case-actors/vendorco-case-actor Offer urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a to https://vultron.example/organizations/coordinator",
  "inReplyTo": "urn:uuid:91c72b7a-27be-4358-8dc4-49012c41be7c",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "content": "We're declining your offer to transfer ownership of case VendorCo Case #20260601 to us.",
  "actor": "https://vultron.example/organizations/coordinator",
  "object": {
    "type": "Offer",
    "id": "urn:uuid:91c72b7a-27be-4358-8dc4-49012c41be7c",
    "name": "https://vultron.example/case-actors/vendorco-case-actor Offer urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a to https://vultron.example/organizations/coordinator",
    "inReplyTo": "urn:uuid:663cc1e5-45b1-4db4-a521-4bcfab4384fb",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "content": "We're offering to transfer ownership of case VendorCo Case #20260601 to you.",
    "to": [
      "https://vultron.example/organizations/coordinator"
    ],
    "attributedTo": "https://vultron.example/organizations/vendorco",
    "actor": "https://vultron.example/case-actors/vendorco-case-actor",
    "target": {
      "type": "Actor",
      "id": "https://vultron.example/organizations/coordinator"
    },
    "object": {
      "type": "VulnerabilityCase",
      "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a"
    }
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/organizations/coordinator#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z3q3eckZswrX2n5ih2FZy6GghahDKb1LyaeKMg6xB69PEdgVCbiizgTqVB9e15wMo1HDfKCeDgZ8dFKRJo7qk7VcE"
  }
}
  • Routing: the Reject is addressed to the CASE_MANAGER, not to the actor that made the offer (CM-21-010). The CASE_MANAGER acts on it only when it comes from the proposed owner of an open offer it recorded (CM-21-013). It records the Reject in the ledger and sends the entry to every participant, which closes the offer (CM-21-012, CM-21-032).
  • Trigger: the recipient sends it with POST /actors/{actor_id}/trigger/reject-case-ownership-transfer, whose body names the offer_id it declines (TRIG-11-005, Trigger API Reference).
  • Triggering transition: none — roster operation.
  • Example artifact: reject_case_ownership_transfer.json.

Withdraw case ownership transfer

Withdraws the proposal, and with it the CASE_MANAGER's offer, before the offer is answered. The current Case Owner keeps the case.

  • When… the Case Owner withdraws its proposal while the offer of case ownership is open
  • Send: Undo(Offer(Offer(VulnerabilityCase)))
  • Send to: the CASE_MANAGER
  • Sent by: the Case Owner
  • Mapping status: none
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Undo",
  "id": "urn:uuid:69d18287-3a13-4005-9304-d7f1ed3a673a",
  "name": "https://vultron.example/organizations/vendorco Undo https://vultron.example/organizations/vendorco Offer https://vultron.example/organizations/vendorco Offer urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a to https://vultron.example/organizations/coordinator",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "content": "We're withdrawing our proposal to transfer ownership of case VendorCo Case #20260601.",
  "to": [
    "https://vultron.example/case-actors/vendorco-case-actor"
  ],
  "actor": "https://vultron.example/organizations/vendorco",
  "object": {
    "type": "Offer",
    "id": "urn:uuid:cec214fd-07ea-49e7-abb0-26e4d8e60e1d",
    "name": "https://vultron.example/organizations/vendorco Offer https://vultron.example/organizations/vendorco Offer urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a to https://vultron.example/organizations/coordinator",
    "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "content": "Please offer ownership of case VendorCo Case #20260601 to the coordinator.",
    "to": [
      "https://vultron.example/case-actors/vendorco-case-actor"
    ],
    "actor": "https://vultron.example/organizations/vendorco",
    "object": {
      "type": "Offer",
      "id": "urn:uuid:72cee889-f890-4611-a267-f431d39b07a0",
      "name": "https://vultron.example/organizations/vendorco Offer urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a to https://vultron.example/organizations/coordinator",
      "published": "2026-06-01T19:12:00.000000+00:00",
      "updated": "2026-06-01T19:12:00.000000+00:00",
      "actor": "https://vultron.example/organizations/vendorco",
      "target": {
        "type": "Actor",
        "id": "https://vultron.example/organizations/coordinator"
      },
      "object": {
        "type": "VulnerabilityCase",
        "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a"
      }
    }
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/organizations/vendorco#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z4F9wrw1N5gff7N5e7dq1yjTHD2NhrPuzbjJTZyhapKRxXjbaxS4bsGAPWuDpKtswyaLzhBZoiGWTetKFZ87eo18"
  }
}
  • Routing: the withdrawal is addressed to the CASE_MANAGER (CM-21-036). It is an Undo of the owner's own proposal. The CASE_MANAGER withdraws the offer that it made from that proposal. It acts only when the withdrawal comes from the Case Owner that the offer was made for, and only while the offer is open. It records the withdrawal in the ledger and sends the entry to every participant, which closes the offer. The proposed owner can no longer accept it, and the case may be offered again (CM-21-014). A withdrawal from anyone else, or of an offer already answered or withdrawn, is refused with nothing recorded. The CASE_MANAGER answers a withdrawal of an offer already answered or withdrawn with the refusal notice, and a withdrawal from anyone else with nothing.
  • Trigger: the Case Owner sends it with POST /actors/{actor_id}/trigger/withdraw-case-ownership-transfer, whose body names, as offer_id, the proposal it withdraws (TRIG-11-006, Trigger API Reference).
  • Triggering transition: none — roster operation.
  • Example artifact: undo_case_ownership_transfer.json.

Invite actor to case

Sends a Stub Invite carrying the case stub and the embargo terms the invitee would agree to.

{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Invite",
  "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/invitation/1",
  "name": "https://vultron.example/organizations/vendorco Invite urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a to Coordinator LLC",
  "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "content": "We're inviting you to participate in VendorCo Case #20260601.",
  "to": "https://vultron.example/organizations/coordinator",
  "actor": "https://vultron.example/organizations/vendorco",
  "target": {
    "type": "Organization",
    "id": "https://vultron.example/organizations/coordinator",
    "name": "Coordinator LLC",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "inbox": {
      "id": "https://vultron.example/organizations/coordinator/inbox",
      "type": "OrderedCollection",
      "items": []
    },
    "outbox": {
      "id": "https://vultron.example/organizations/coordinator/outbox",
      "type": "OrderedCollection",
      "items": []
    }
  },
  "object": {
    "type": "VulnerabilityCase",
    "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
    "preview": {
      "id": "urn:uuid:9e0065c7-3f7e-44ef-ac6b-fcaf9a079572",
      "type": "CasePreview",
      "summary": "A memory-corruption vulnerability in widget — details shared after acceptance."
    }
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/organizations/vendorco#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z2wt9scugjbfLUP9LgbkF4Lf9G22yFH6e9xpB6DXREJo7Nh5DjyV8nLokhcSCyWZHXZAi1r52eVMepGyKGHZwxKTd"
  }
}
  • Who decides: the Case Owner decides whom to invite. A participant that wants a third party brought in sends a recommendation instead (Suggest actor to case). See §12.2 Invitation and Acceptance.
  • Triggering transition: none — roster action.
  • Object and target: the object is the case, and the target is the actor being invited, as ActivityStreams 2.0 puts them (ADR-0205). The invitee may not see the case yet, so the object is a typed reference to the case: its id is the case's identifier, its type is VulnerabilityCase, and its preview is the case stub. The stub, of type CasePreview, carries a required summary field: the owner-chosen description the invitee reads before deciding whether to accept (CM-11-013, CM-17-010, MV-10-001). The stub names no case of its own: the reference's id names the case. The factory raises VultronActivityConstructionError when VulnerabilityCase.stub_summary is not set, or when it is given a bare case URI instead of the case, and the receiver refuses a stub with an absent or blank summary. The receiver reads the reference as it arrived: it does not fetch the case, put its own copy of the case in the reference's place, or seed a replica from the preview (MV-10-013). Any value inside the stub may be a Redacted marker, {"type": "Redacted", "summary": "<reason>"}: the sender has the value but does not show it to the invitee (MV-12-001, MV-12-003). The receiver reads the stub as the sender sent it, including a nested object cut down to a few fields (MV-12-006). It decides on the Invite, not on what the stub leaves out. A marker carries no field but type and summary (MV-12-005). The receiver sets aside and reports any other field a received marker carries (MV-11-003). It refuses a marker anywhere outside a preview (MV-12-002). The preview of that reference is the only place a stub may appear, wherever the Invite travels inline: in its Accept or Reject, or in a refusal notice that quotes such a reply (MV-10-002). The receiver refuses an activity that carries a stub anywhere else, an Invite's target and an embargo Invite included. The Invite names at least one CVD role for the invitee, and the CASE_MANAGER refuses to send one with an empty role list (CM-11-019, CM-11-048). The Invite carries its reply deadline in endTime. The CASE_MANAGER sets that deadline the same way it sets an embargo Invite's deadline. The deadline is the Invite's published time plus the configured RSVP window, capped at the end of the active embargo (CM-11-014, CM-28-012). When the deadline passes, the Invite closes and the invitee's record does not change. A reply after the deadline is still processed: an Accept joins the invitee and a Reject closes the record. The CASE_MANAGER can re-invite an actor with a fresh stub Invite on the same record and a new deadline. The fresh Invite's inReplyTo names the earlier one (CM-11-042). A re-invite of a participant that has closed is refused. When the active embargo is activated, revised or terminated while a stub Invite is outstanding, the CASE_MANAGER sends a replacement with the current terms and a new deadline. The replacement names the Invite it supersedes in the standard AS2 inReplyTo property. The replacement is also an invitation to the embargo now in force. The CASE_MANAGER marks the invitee's consent row for that embargo INVITED with the replacement's deadline. It records the row as its own ledger entry, after the replacement's entry. With no embargo in force, no consent row changes. An Accept of the superseded Invite is refused, naming the replacement, and a Reject of it is honored (CM-11-045, CM-11-046).
  • Ask kind: the Invite closes on Accept or Reject of it (INVITE_ACTOR_TO_CASE_REPLY_TYPES), and its expiry is stale: a late reply is still processed (ASK-03-008).
  • Example artifact: invite_to_case.json.

Accept invite to case

Accepts the Stub Invite. The actor joins the case at RM Received.

{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Accept",
  "id": "urn:uuid:173a51df-dc7d-4b4b-abcb-6e1d9e85683c",
  "name": "https://vultron.example/organizations/coordinator Accept https://vultron.example/organizations/vendorco Invite urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a to Coordinator LLC",
  "inReplyTo": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/invitation/1",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "content": "We're accepting your invitation to participate in VendorCo Case #20260601.",
  "to": "https://vultron.example/organizations/vendorco",
  "actor": "https://vultron.example/organizations/coordinator",
  "object": {
    "type": "Invite",
    "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/invitation/1",
    "name": "https://vultron.example/organizations/vendorco Invite urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a to Coordinator LLC",
    "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "content": "We're inviting you to participate in VendorCo Case #20260601.",
    "to": "https://vultron.example/organizations/coordinator",
    "actor": "https://vultron.example/organizations/vendorco",
    "target": {
      "type": "Organization",
      "id": "https://vultron.example/organizations/coordinator",
      "name": "Coordinator LLC",
      "published": "2026-06-01T19:12:00.000000+00:00",
      "updated": "2026-06-01T19:12:00.000000+00:00",
      "inbox": {
        "id": "https://vultron.example/organizations/coordinator/inbox",
        "type": "OrderedCollection",
        "items": []
      },
      "outbox": {
        "id": "https://vultron.example/organizations/coordinator/outbox",
        "type": "OrderedCollection",
        "items": []
      }
    },
    "object": {
      "type": "VulnerabilityCase",
      "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
      "preview": {
        "id": "urn:uuid:48cfb5e0-57c9-454c-aecd-1d442cf25d1a",
        "type": "CasePreview",
        "summary": "A memory-corruption vulnerability in widget — details shared after acceptance."
      }
    }
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/organizations/coordinator#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z4B3rNj5EvKSPhrtZPXvL92XUihbB9zBBRtTWoiTt8whzWTW1yoohWW4jWMHUXEDxFZSesS2LCt1mt8kyHAdZHSdX"
  }
}
  • Effects: the CASE_MANAGER records the acceptance in the ledger, marks the participant's existing record joined, and then sends Announce(VulnerabilityCase) to seed the new participant's replica (CM-17-004). An Accept from an invitee with no participant record is refused with a reported reason and writes nothing, because an Accept never creates a participant (CM-11-021, CM-11-052). The Accept is the ledger entry for its own effects (the consent row and joined), which a replica applies. The record's creation and a vendor's VF status have their own entries. The CASE_MANAGER sends no Add(CaseParticipant) for it (CM-31-012).
  • What it does not do: it joins the case and consents to the active embargo. It does not judge the case. The participant judges the case by answering the Full-Case Invite that follows.
  • Example artifact: accept_invite_to_case.json.

Reject invite to case

Rejects the Stub Invite, which closes the invitee's participant record.

  • When… an invited actor declines to join the case
  • Send: Reject(Invite(VulnerabilityCase preview)[target=Actor])
  • Send to: the CASE_MANAGER
  • Sent by: the invitee
  • Seen in: How to Invite an Actor to a Case
  • Mapping status: none
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Reject",
  "id": "urn:uuid:ce545c4b-657d-476d-85a9-5ced86b59ebd",
  "name": "https://vultron.example/organizations/coordinator Reject https://vultron.example/organizations/vendorco Invite urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a to Coordinator LLC",
  "inReplyTo": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/invitation/1",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "content": "Thanks for the invitation, but we're declining to participate in VendorCo Case #20260601.",
  "to": "https://vultron.example/organizations/vendorco",
  "actor": "https://vultron.example/organizations/coordinator",
  "object": {
    "type": "Invite",
    "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/invitation/1",
    "name": "https://vultron.example/organizations/vendorco Invite urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a to Coordinator LLC",
    "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "content": "We're inviting you to participate in VendorCo Case #20260601.",
    "to": "https://vultron.example/organizations/coordinator",
    "actor": "https://vultron.example/organizations/vendorco",
    "target": {
      "type": "Organization",
      "id": "https://vultron.example/organizations/coordinator",
      "name": "Coordinator LLC",
      "published": "2026-06-01T19:12:00.000000+00:00",
      "updated": "2026-06-01T19:12:00.000000+00:00",
      "inbox": {
        "id": "https://vultron.example/organizations/coordinator/inbox",
        "type": "OrderedCollection",
        "items": []
      },
      "outbox": {
        "id": "https://vultron.example/organizations/coordinator/outbox",
        "type": "OrderedCollection",
        "items": []
      }
    },
    "object": {
      "type": "VulnerabilityCase",
      "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
      "preview": {
        "id": "urn:uuid:b1aecde4-77e5-4d60-a1b8-eb5c0b992ecd",
        "type": "CasePreview",
        "summary": "A memory-corruption vulnerability in widget — details shared after acceptance."
      }
    }
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/organizations/coordinator#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z2eVssZzB5URVddniadGvtbc4fRJ8HGBLpCFqGRd88YWzsLbqHHBBa1fckQXcGSMQSp9A1cgW7eSyK8Ej988AnD87"
  }
}
  • Effects: the CASE_MANAGER moves the invitee's record to RM Closed and keeps it, and the participant stays inert (CM-11-007). A Reject from an invitee that has no participant record is refused with a reported reason, not ignored (CM-11-018).
  • Triggering transition: none — roster action.
  • Example artifact: reject_invite_to_case.json.

Send Full-Case Invite

Sends the Full-Case Invite, which asks the Participant to judge the case. It carries the CASE_MANAGER's ledger position as the floor the reply must reach.

  • When… the CASE_MANAGER has replayed the case ledger to a newly joined Participant
  • Send: Invite(whole VulnerabilityCase)[target=Actor]
  • Send to: a participant
  • Sent by: the CASE_MANAGER
  • Seen in: How to Manage a Case Roster
  • Mapping status: none
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Invite",
  "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/full-case-invitation/1",
  "name": "https://vultron.example/case-actors/vendorco-case-actor Invite VendorCo Case #20260601 to Coordinator LLC",
  "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "to": "https://vultron.example/organizations/coordinator",
  "actor": "https://vultron.example/case-actors/vendorco-case-actor",
  "target": {
    "type": "Organization",
    "id": "https://vultron.example/organizations/coordinator",
    "name": "Coordinator LLC",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "inbox": {
      "id": "https://vultron.example/organizations/coordinator/inbox",
      "type": "OrderedCollection",
      "items": []
    },
    "outbox": {
      "id": "https://vultron.example/organizations/coordinator/outbox",
      "type": "OrderedCollection",
      "items": []
    }
  },
  "ledgerPosition": {
    "logIndex": 4,
    "entryHash": "b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5"
  },
  "object": {
    "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
    "type": "VulnerabilityCase",
    "name": "VendorCo Case #20260601",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "attributedTo": "https://vultron.example/organizations/vendorco",
    "caseParticipants": [],
    "actorParticipantIndex": {},
    "vulnerabilityReports": [],
    "vulnerabilityItems": [],
    "caseReferences": [],
    "caseStatuses": [
      {
        "id": "urn:uuid:3046e666-a79a-45b5-8a38-f3b5ed0950ed",
        "type": "CaseStatus",
        "name": "NONE pxa",
        "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
        "published": "2026-06-01T19:12:00.000000+00:00",
        "attributedTo": "https://vultron.example/organizations/vendorco",
        "emState": "NONE",
        "pxaState": "pxa"
      }
    ],
    "notes": [],
    "embargoRegister": [],
    "pendingEmbargoProposalIndex": {},
    "caseActivity": [],
    "genesisHash": "41ebcb1d996477859b8fec00382f75af72401ede0814022bab3f0d54f1b25e0d",
    "ledgerPosition": {
      "logIndex": -1,
      "entryHash": "41ebcb1d996477859b8fec00382f75af72401ede0814022bab3f0d54f1b25e0d"
    },
    "parentCases": [],
    "childCases": [],
    "siblingCases": [],
    "activeParticipants": []
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/case-actors/vendorco-case-actor#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z4gLbKwxKGCVyewZnf3C1R8sMuXst5Me2tSK7pjYoopdDCTfk8ZT9Ev13Meqsgo3LoMEVxEH3888mxcpg2XJgukfq"
  }
}
  • Sequence: after a participant joins, the CASE_MANAGER sends Announce(VulnerabilityCase), starts the ledger replay, and then asks the participant to judge the case with the full-case Invite (CM-11-010, ADR-0121). The Invite asks one question: is this case valid?
  • Triggering transition: none — the Invite asks, and the reply moves RM.
  • Object and target: the object is the whole case, and the target is the participant (ADR-0205). The participant has joined, so it may see the whole case; the receiver tells this Invite from the stub Invite by that form of its object, a whole case rather than a reference carrying a preview (SE-01-009). The CASE_MANAGER's ledger position when it issued the Invite travels as the Invite's ledgerPosition, the property every case activity carries, for example "ledgerPosition": {"logIndex": 3, "entryHash": "<hash>"} (SYNC-18-001). It is a floor: the participant's reply must reach at least this point in the ledger (VAM-04-011). An empty ledger is logIndex -1 with the case's genesisHash as entryHash (CLP-08-004).
  • Ask kind: the Invite closes on Accept, TentativeReject or Reject of it (INVITE_ACTOR_TO_FULL_CASE_REPLY_TYPES).

Accept Full-Case Invite

Accepts the Full-Case Invite, which records RM Valid. It carries the sender's own ledger position.

  • When… a Participant asked by a Full-Case Invite judges the case valid
  • Send: Accept(Invite(whole VulnerabilityCase)[target=Actor])
  • Send to: the CASE_MANAGER
  • Sent by: the invitee
  • Seen in: How to Manage a Case Roster
  • Formal definition: Report Valid (RV)
  • Mapping status: expansion
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Accept",
  "id": "urn:uuid:59d8109b-effb-4ead-ab33-2fdb21a37399",
  "name": "https://vultron.example/organizations/coordinator Accept https://vultron.example/case-actors/vendorco-case-actor Invite VendorCo Case #20260601 to Coordinator LLC",
  "inReplyTo": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/full-case-invitation/1",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "to": "https://vultron.example/case-actors/vendorco-case-actor",
  "actor": "https://vultron.example/organizations/coordinator",
  "ledgerPosition": {
    "logIndex": 4,
    "entryHash": "b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5"
  },
  "object": {
    "type": "Invite",
    "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/full-case-invitation/1",
    "name": "https://vultron.example/case-actors/vendorco-case-actor Invite VendorCo Case #20260601 to Coordinator LLC",
    "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "to": "https://vultron.example/organizations/coordinator",
    "actor": "https://vultron.example/case-actors/vendorco-case-actor",
    "target": {
      "type": "Organization",
      "id": "https://vultron.example/organizations/coordinator",
      "name": "Coordinator LLC",
      "published": "2026-06-01T19:12:00.000000+00:00",
      "updated": "2026-06-01T19:12:00.000000+00:00",
      "inbox": {
        "id": "https://vultron.example/organizations/coordinator/inbox",
        "type": "OrderedCollection",
        "items": []
      },
      "outbox": {
        "id": "https://vultron.example/organizations/coordinator/outbox",
        "type": "OrderedCollection",
        "items": []
      }
    },
    "ledgerPosition": {
      "logIndex": 4,
      "entryHash": "b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5"
    },
    "object": {
      "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
      "type": "VulnerabilityCase",
      "name": "VendorCo Case #20260601",
      "published": "2026-06-01T19:12:00.000000+00:00",
      "updated": "2026-06-01T19:12:00.000000+00:00",
      "attributedTo": "https://vultron.example/organizations/vendorco",
      "caseParticipants": [],
      "actorParticipantIndex": {},
      "vulnerabilityReports": [],
      "vulnerabilityItems": [],
      "caseReferences": [],
      "caseStatuses": [
        {
          "id": "urn:uuid:3046e666-a79a-45b5-8a38-f3b5ed0950ed",
          "type": "CaseStatus",
          "name": "NONE pxa",
          "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
          "published": "2026-06-01T19:12:00.000000+00:00",
          "attributedTo": "https://vultron.example/organizations/vendorco",
          "emState": "NONE",
          "pxaState": "pxa"
        }
      ],
      "notes": [],
      "embargoRegister": [],
      "pendingEmbargoProposalIndex": {},
      "caseActivity": [],
      "genesisHash": "41ebcb1d996477859b8fec00382f75af72401ede0814022bab3f0d54f1b25e0d",
      "ledgerPosition": {
        "logIndex": -1,
        "entryHash": "41ebcb1d996477859b8fec00382f75af72401ede0814022bab3f0d54f1b25e0d"
      },
      "parentCases": [],
      "childCases": [],
      "siblingCases": [],
      "activeParticipants": []
    }
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/organizations/coordinator#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z3XNbWLuSJ3GLQYZpb4jV5bS7nTVd3wQyZfRqxb9dXHbaWC4a6UPh2WdWzkHkGwLWsPDFf93UqHGKmsenbEyqxJDJ"
  }
}
  • Effects: the participant judges the case valid (Validate report), and the CASE_MANAGER records RM Received → Valid (CM-11-011).
  • Ledger position: the reply carries the participant's own ledger position as its ledgerPosition, in the same form as the Invite (VAM-04-012). The CASE_MANAGER refuses a reply whose position is behind the Invite's, or names an entry its ledger does not hold, and writes nothing (CM-11-012). It also refuses, and writes nothing for, a reply from an inert participant that has not joined the case (CM-11-036).

Tentatively reject Full-Case Invite

Tentatively rejects the Full-Case Invite, which records RM Invalid. It carries the sender's own ledger position.

  • When… a Participant asked by a Full-Case Invite judges the case invalid
  • Send: TentativeReject(Invite(whole VulnerabilityCase)[target=Actor])
  • Send to: the CASE_MANAGER
  • Sent by: the invitee
  • Seen in: How to Manage a Case Roster
  • Formal definition: Report Invalid (RI)
  • Mapping status: expansion
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "TentativeReject",
  "id": "urn:uuid:0a25a856-b869-44cf-96b1-d4be8903f756",
  "name": "https://vultron.example/organizations/coordinator TentativeReject https://vultron.example/case-actors/vendorco-case-actor Invite VendorCo Case #20260601 to Coordinator LLC",
  "inReplyTo": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/full-case-invitation/1",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "to": "https://vultron.example/case-actors/vendorco-case-actor",
  "actor": "https://vultron.example/organizations/coordinator",
  "ledgerPosition": {
    "logIndex": 4,
    "entryHash": "b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5"
  },
  "object": {
    "type": "Invite",
    "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/full-case-invitation/1",
    "name": "https://vultron.example/case-actors/vendorco-case-actor Invite VendorCo Case #20260601 to Coordinator LLC",
    "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "to": "https://vultron.example/organizations/coordinator",
    "actor": "https://vultron.example/case-actors/vendorco-case-actor",
    "target": {
      "type": "Organization",
      "id": "https://vultron.example/organizations/coordinator",
      "name": "Coordinator LLC",
      "published": "2026-06-01T19:12:00.000000+00:00",
      "updated": "2026-06-01T19:12:00.000000+00:00",
      "inbox": {
        "id": "https://vultron.example/organizations/coordinator/inbox",
        "type": "OrderedCollection",
        "items": []
      },
      "outbox": {
        "id": "https://vultron.example/organizations/coordinator/outbox",
        "type": "OrderedCollection",
        "items": []
      }
    },
    "ledgerPosition": {
      "logIndex": 4,
      "entryHash": "b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5"
    },
    "object": {
      "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
      "type": "VulnerabilityCase",
      "name": "VendorCo Case #20260601",
      "published": "2026-06-01T19:12:00.000000+00:00",
      "updated": "2026-06-01T19:12:00.000000+00:00",
      "attributedTo": "https://vultron.example/organizations/vendorco",
      "caseParticipants": [],
      "actorParticipantIndex": {},
      "vulnerabilityReports": [],
      "vulnerabilityItems": [],
      "caseReferences": [],
      "caseStatuses": [
        {
          "id": "urn:uuid:3046e666-a79a-45b5-8a38-f3b5ed0950ed",
          "type": "CaseStatus",
          "name": "NONE pxa",
          "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
          "published": "2026-06-01T19:12:00.000000+00:00",
          "attributedTo": "https://vultron.example/organizations/vendorco",
          "emState": "NONE",
          "pxaState": "pxa"
        }
      ],
      "notes": [],
      "embargoRegister": [],
      "pendingEmbargoProposalIndex": {},
      "caseActivity": [],
      "genesisHash": "41ebcb1d996477859b8fec00382f75af72401ede0814022bab3f0d54f1b25e0d",
      "ledgerPosition": {
        "logIndex": -1,
        "entryHash": "41ebcb1d996477859b8fec00382f75af72401ede0814022bab3f0d54f1b25e0d"
      },
      "parentCases": [],
      "childCases": [],
      "siblingCases": [],
      "activeParticipants": []
    }
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/organizations/coordinator#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z2Wz9MAaUozsg5JNdF3jFhVSHn2YAyCQS8HScDdYgvbcGANkPpSjrSxBJJay4AsbbKhnRRtCm7WEVqRJYhRUbfBS5"
  }
}
  • Effects: the participant judges the case invalid (Invalidate report), and the CASE_MANAGER records RM Received → Invalid. The stub Invite has no TentativeReject, because accepting a stub judges nothing (CM-11-028).
  • Ledger position: the reply carries the participant's ledger position as its ledgerPosition (VAM-04-013).

Reject Full-Case Invite

Rejects the Full-Case Invite, which records RM Closed. It carries the sender's own ledger position.

  • When… a Participant asked by a Full-Case Invite closes the case
  • Send: Reject(Invite(whole VulnerabilityCase)[target=Actor])
  • Send to: the CASE_MANAGER
  • Sent by: the invitee
  • Seen in: How to Manage a Case Roster
  • Formal definition: Report Closed (RC)
  • Mapping status: expansion
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Reject",
  "id": "urn:uuid:80189271-93a6-4464-96d7-55235b6ecfe5",
  "name": "https://vultron.example/organizations/coordinator Reject https://vultron.example/case-actors/vendorco-case-actor Invite VendorCo Case #20260601 to Coordinator LLC",
  "inReplyTo": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/full-case-invitation/1",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "to": "https://vultron.example/case-actors/vendorco-case-actor",
  "actor": "https://vultron.example/organizations/coordinator",
  "ledgerPosition": {
    "logIndex": 4,
    "entryHash": "b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5"
  },
  "object": {
    "type": "Invite",
    "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/full-case-invitation/1",
    "name": "https://vultron.example/case-actors/vendorco-case-actor Invite VendorCo Case #20260601 to Coordinator LLC",
    "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "to": "https://vultron.example/organizations/coordinator",
    "actor": "https://vultron.example/case-actors/vendorco-case-actor",
    "target": {
      "type": "Organization",
      "id": "https://vultron.example/organizations/coordinator",
      "name": "Coordinator LLC",
      "published": "2026-06-01T19:12:00.000000+00:00",
      "updated": "2026-06-01T19:12:00.000000+00:00",
      "inbox": {
        "id": "https://vultron.example/organizations/coordinator/inbox",
        "type": "OrderedCollection",
        "items": []
      },
      "outbox": {
        "id": "https://vultron.example/organizations/coordinator/outbox",
        "type": "OrderedCollection",
        "items": []
      }
    },
    "ledgerPosition": {
      "logIndex": 4,
      "entryHash": "b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5b2c3d4e5"
    },
    "object": {
      "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
      "type": "VulnerabilityCase",
      "name": "VendorCo Case #20260601",
      "published": "2026-06-01T19:12:00.000000+00:00",
      "updated": "2026-06-01T19:12:00.000000+00:00",
      "attributedTo": "https://vultron.example/organizations/vendorco",
      "caseParticipants": [],
      "actorParticipantIndex": {},
      "vulnerabilityReports": [],
      "vulnerabilityItems": [],
      "caseReferences": [],
      "caseStatuses": [
        {
          "id": "urn:uuid:3046e666-a79a-45b5-8a38-f3b5ed0950ed",
          "type": "CaseStatus",
          "name": "NONE pxa",
          "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
          "published": "2026-06-01T19:12:00.000000+00:00",
          "attributedTo": "https://vultron.example/organizations/vendorco",
          "emState": "NONE",
          "pxaState": "pxa"
        }
      ],
      "notes": [],
      "embargoRegister": [],
      "pendingEmbargoProposalIndex": {},
      "caseActivity": [],
      "genesisHash": "41ebcb1d996477859b8fec00382f75af72401ede0814022bab3f0d54f1b25e0d",
      "ledgerPosition": {
        "logIndex": -1,
        "entryHash": "41ebcb1d996477859b8fec00382f75af72401ede0814022bab3f0d54f1b25e0d"
      },
      "parentCases": [],
      "childCases": [],
      "siblingCases": [],
      "activeParticipants": []
    }
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/organizations/coordinator#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "zXDS1co74EesrsYwUMjBe3kRbhJpVWJPfu2HUzL7ZWtertaHUMYujdCXnQS88z23wzAqueuEiqtWSSjuheqxLjGJ"
  }
}
  • Effects: the participant closes the case (Close report), and the CASE_MANAGER records RM Received → Closed. The participant stops receiving case content.
  • Ledger position: the reply carries the participant's ledger position as its ledgerPosition (VAM-04-014).

Announce vulnerability case

Sends the full case to the newly admitted Participant once its acceptance clears the embargo consent checks.

  • When… the CASE_MANAGER has admitted a new Participant to the case
  • Send: Announce(VulnerabilityCase)
  • Send to: a participant
  • Sent by: the CASE_MANAGER
  • Seen in: How to Invite an Actor to a Case
  • Mapping status: none
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Announce",
  "id": "urn:uuid:6a39650d-c253-4913-9ea4-10a5522d0e8e",
  "name": "https://vultron.example/organizations/vendorco Announce VendorCo Case #20260601",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "actor": "https://vultron.example/organizations/vendorco",
  "object": {
    "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
    "type": "VulnerabilityCase",
    "name": "VendorCo Case #20260601",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "attributedTo": "https://vultron.example/organizations/vendorco",
    "caseParticipants": [
      {
        "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/participants/finndervul",
        "type": "CaseParticipant",
        "name": "Finn der Vul",
        "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
        "published": "2026-06-01T19:12:00.000000+00:00",
        "updated": "2026-06-01T19:12:00.000000+00:00",
        "attributedTo": "https://vultron.example/users/finndervul",
        "caseRoles": [
          "reporter"
        ],
        "participantStatuses": [
          {
            "id": "urn:uuid:81fb28e9-f0d6-4a8f-a4c5-6bdf0993bcbd",
            "type": "ParticipantStatus",
            "name": "START",
            "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
            "published": "2026-06-01T19:12:00.000000+00:00",
            "updated": "2026-06-01T19:12:00.000000+00:00",
            "attributedTo": "https://vultron.example/users/finndervul",
            "rmState": "START",
            "caseEngagement": true,
            "cvdRole": [
              "REPORTER"
            ]
          }
        ],
        "embargoConsents": [],
        "joined": true
      },
      {
        "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/participants/vendorco",
        "type": "CaseParticipant",
        "name": "VendorCo",
        "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
        "published": "2026-06-01T19:12:00.000000+00:00",
        "updated": "2026-06-01T19:12:00.000000+00:00",
        "attributedTo": "https://vultron.example/organizations/vendorco",
        "caseRoles": [
          "vendor"
        ],
        "participantStatuses": [
          {
            "id": "urn:uuid:191656de-2e30-42ca-a253-ba0a8f4b2691",
            "type": "ParticipantStatus",
            "name": "RECEIVED Vf",
            "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
            "published": "2026-06-01T19:12:00.000000+00:00",
            "updated": "2026-06-01T19:12:00.000000+00:00",
            "attributedTo": "https://vultron.example/organizations/vendorco",
            "rmState": "RECEIVED",
            "vfState": "Vf",
            "caseEngagement": true,
            "cvdRole": [
              "OBSERVER"
            ]
          }
        ],
        "embargoConsents": [],
        "joined": true
      }
    ],
    "actorParticipantIndex": {
      "https://vultron.example/users/finndervul": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/participants/finndervul",
      "https://vultron.example/organizations/vendorco": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/participants/vendorco"
    },
    "vulnerabilityReports": [
      {
        "id": "https://demo.vultron.local/VulnerabilityReport/17a7b3e5-d74e-481e-ad90-2b9ab88c6dac",
        "type": "VulnerabilityReport",
        "name": "FDR-8675309",
        "published": "2026-06-01T19:12:00.000000+00:00",
        "updated": "2026-06-01T19:12:00.000000+00:00",
        "content": "I found a vulnerability!",
        "attributedTo": "https://vultron.example/users/finndervul"
      }
    ],
    "vulnerabilityItems": [],
    "caseReferences": [],
    "caseStatuses": [
      {
        "id": "urn:uuid:1515cb74-25a7-4922-8f02-d0ff36ba7822",
        "type": "CaseStatus",
        "name": "NONE pxa",
        "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
        "published": "2026-06-01T19:12:00.000000+00:00",
        "attributedTo": "https://vultron.example/organizations/vendorco",
        "emState": "NONE",
        "pxaState": "pxa"
      }
    ],
    "notes": [],
    "embargoRegister": [],
    "pendingEmbargoProposalIndex": {},
    "caseActivity": [],
    "genesisHash": "41ebcb1d996477859b8fec00382f75af72401ede0814022bab3f0d54f1b25e0d",
    "ledgerPosition": {
      "logIndex": -1,
      "entryHash": "41ebcb1d996477859b8fec00382f75af72401ede0814022bab3f0d54f1b25e0d"
    },
    "parentCases": [],
    "childCases": [],
    "siblingCases": [],
    "activeParticipants": [
      "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/participants/finndervul",
      "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/participants/vendorco"
    ]
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/organizations/vendorco#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z4J5gJPv9kLKAJtyGM96TcyYvWoUVUaZ6gEah5buP6YU7iL6roYiMhE6K9TydJdksL2qoH2hLgqr4fwhE1EfzZjGb"
  }
}
  • Contents: the full VulnerabilityCase object is delivered inline so the recipient can seed its local replica (PCR-02-002). The same activity delivers a full case snapshot at every later lifecycle stage (PCR-02-001).
  • Triggering transition: none — roster action following invite acceptance.
  • Example artifact: announce_case.json.

Close case

Leaves the case, moving the sender's RM state to Closed.

{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Leave",
  "id": "urn:uuid:a1aa73db-a618-4394-98b9-95f7ea83de39",
  "name": "https://vultron.example/organizations/vendorco Leave urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "content": "We're closing this case.",
  "actor": "https://vultron.example/organizations/vendorco",
  "object": {
    "type": "VulnerabilityCase",
    "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a"
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/organizations/vendorco#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z2DHdA474HWxamKz7pxHj7UiivUqmVWMBCfXqsy3Hc4dKH8MWBaLU4USNZJ6B4eDPhNuy2kkXbgSDhMQnGPEoicCq"
  }
}
  • Triggering transition: RM: A → C.
  • Object: the case, as a typed reference: an inline object with only its id and type (AKM-03-004, ADR-0165). The CASE_MANAGER reads the case from its own store and refuses a case it does not hold (AKM-03-006). A full case that another sender still carries is not refused, but the CASE_MANAGER reads only its id and stores nothing from it (AKM-03-005).
  • Refusal: while the case holds an active embargo, the CASE_MANAGER refuses the Case Owner's close and records nothing (CM-23-011). It answers with the refusal notice, a Refuse of the Leave that names the embargo in summary (CLP-05-001).
  • Example artifact: close_case.json.

Add case participant to case

Asks the CASE_MANAGER to reinstate the participant record named by the object. The Participant becomes active again and receives the ledger entries it missed.

  • When… the Case Owner reinstates a removed Participant
  • Send: Add(CaseParticipant)[target=VulnerabilityCase]
  • Send to: the CASE_MANAGER
  • Sent by: the Case Owner
  • Seen in: How to Manage a Case Roster
  • Mapping status: none
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Add",
  "id": "urn:uuid:87e53760-1733-48e0-a89f-e7f8567fc4f8",
  "name": "https://vultron.example/organizations/vendorco Add Coordinator LLC to urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "content": "We're reinstating the coordinator in this case.",
  "actor": "https://vultron.example/organizations/vendorco",
  "target": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "object": {
    "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/participants/coordinator",
    "type": "CaseParticipant",
    "name": "Coordinator LLC",
    "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "attributedTo": "https://vultron.example/organizations/coordinator",
    "caseRoles": [
      "coordinator"
    ],
    "participantStatuses": [
      {
        "id": "urn:uuid:94423d36-7e74-4433-b108-786eb3c87905",
        "type": "ParticipantStatus",
        "name": "START",
        "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
        "published": "2026-06-01T19:12:00.000000+00:00",
        "updated": "2026-06-01T19:12:00.000000+00:00",
        "attributedTo": "https://vultron.example/organizations/coordinator",
        "rmState": "START",
        "caseEngagement": true,
        "cvdRole": [
          "COORDINATOR"
        ]
      }
    ],
    "embargoConsents": [],
    "joined": true
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/organizations/vendorco#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "zN5nQXZMtKkJz5JqYUvhcpkrzG9D3dMnd3GnK3u7gEvhY3Rdp11PxK8BUk8EXiNRkjL6eHXkyNKMPKEPTg5zTkPR"
  }
}
  • Reinstatement: it clears the participant's removal fact, so the participant is entitled to case content again. It does not ask the participant to accept again. Add(CaseParticipant) does not seat a new member: an actor joins a case by accepting its stub Invite (see Accept Invite to Case).
  • Triggering transition: none — the participant's record loses its removal fact.
  • Who may send: The CASE_MANAGER admits it only from the Case Owner. It refuses an Add that names a participant that is not removed, a participant that never joined the case, or no participant of the case. It also refuses an Add whose participant gives an attributedTo other than the actor of the record it names. The reason is that each replica finds its own copy of the record by that actor. A participant replica accepts it only from the CASE_MANAGER, as the direct notice below, and writes nothing from it.
  • Ledger: the Case Owner's received Add is the one ledger entry for the reinstatement. Every replica applies the reinstatement from that entry, the reinstated participant's own included.
  • Catch-up: after the participant is active again, the CASE_MANAGER sends it every ledger entry committed after its removal entry. It sends the entries in log order, so the participant's copy of the ledger has no gap. A participant that is not a signatory to the active embargo stays inert: the CASE_MANAGER sends it that embargo's Invite instead, and the catch-up waits until it accepts.
  • Notice: the CASE_MANAGER also sends the reinstated participant a direct Add(CaseParticipant) naming it, with actor set to the CASE_MANAGER and attributedTo set to the Case Owner. Its inReplyTo names the Case Owner's Add. The notice is not ledgered.
  • Spec: Participant Removal.

The example above shows a Vendor that holds the Case Owner role reinstating a Coordinator. The wire shape is the same whatever roles the participant holds. Only caseRoles on the attached object differs.

Remove case participant from case

Asks the CASE_MANAGER to remove the participant record named by the object. The removed Participant receives a direct notice.

  • When… the Case Owner removes a Participant from active participation
  • Send: Remove(CaseParticipant)[target=VulnerabilityCase]
  • Send to: the CASE_MANAGER
  • Sent by: the Case Owner
  • Seen in: How to Manage a Case Roster
  • Mapping status: none
{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Remove",
  "id": "urn:uuid:dbe1756a-4767-4c6d-ba1d-547acf91faa4",
  "name": "https://vultron.example/organizations/vendorco Remove Coordinator LLC to urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "summary": "Vendor is removing the coordinator from the case.",
  "actor": "https://vultron.example/organizations/vendorco",
  "target": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "object": {
    "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/participants/coordinator",
    "type": "CaseParticipant",
    "name": "Coordinator LLC",
    "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "attributedTo": "https://vultron.example/organizations/coordinator",
    "caseRoles": [
      "coordinator"
    ],
    "participantStatuses": [
      {
        "id": "urn:uuid:bab3a566-7e67-4d87-b1fe-a829423f27fa",
        "type": "ParticipantStatus",
        "name": "START",
        "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
        "published": "2026-06-01T19:12:00.000000+00:00",
        "updated": "2026-06-01T19:12:00.000000+00:00",
        "attributedTo": "https://vultron.example/organizations/coordinator",
        "rmState": "START",
        "caseEngagement": true,
        "cvdRole": [
          "COORDINATOR"
        ]
      }
    ],
    "embargoConsents": [],
    "joined": true
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/organizations/vendorco#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z27Hhqhv3pVjNsm8yNLRvrdqHU4AyprPUM34XMdZPe2jXxdTkSVPMu7sKxj95PrvJvTVtmp6XZeuN1qMy32MZmuTw"
  }
}
  • Removal: it withdraws the participant's entitlement to case content. The participant's record stays on the case roster.
  • Triggering transition: none — the participant's record gains a removal fact.
  • Target: the case MUST be named in target. A Remove that names the case only in origin is not recognized as this message.
  • Who may send: The CASE_MANAGER admits it only from the Case Owner. It refuses a removal of the CASE_MANAGER's or the Case Owner's participant, and a removal that names no participant of the case. It also refuses a removal whose participant gives an attributedTo other than the actor of the record it names. The reason is that each replica finds its own copy of the record by that actor. A participant replica accepts it only from the CASE_MANAGER, as the direct notice below, and writes nothing from it.
  • Ledger: the Case Owner's received Remove is the one ledger entry for the removal. Every replica applies the removal from that entry, the removed participant's own included.
  • Notice: the CASE_MANAGER then sends the removed participant a direct Remove(CaseParticipant) naming it, with actor set to the CASE_MANAGER and attributedTo set to the Case Owner. Its inReplyTo names the Case Owner's Remove. The notice is not ledgered.
  • Spec: Participant Removal.
  • Example artifact: remove_participant_from_case.json.

Update Case Owner

Carries the case with its new owner in attributedTo. The CASE_MANAGER commits it after the Accept of the transfer and after each participant record whose CASE_OWNER role moved.

  • When… the CASE_MANAGER records the new Case Owner once a case ownership transfer is accepted
  • Send: Update(VulnerabilityCase)
  • Send to: a participant
  • Sent by: internal to the CASE_MANAGER
  • Mapping status: none

Each participant learns of it from the case ledger, so it is addressed to nobody.

{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Update",
  "id": "urn:uuid:3237539a-639f-4cf5-a052-e490db76a492",
  "name": "https://vultron.example/case-actors/vendorco-case-actor Update VendorCo Case #20260601",
  "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "actor": "https://vultron.example/case-actors/vendorco-case-actor",
  "object": {
    "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
    "type": "VulnerabilityCase",
    "name": "VendorCo Case #20260601",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "attributedTo": "https://vultron.example/organizations/vendorco",
    "caseParticipants": [],
    "actorParticipantIndex": {},
    "vulnerabilityReports": [],
    "vulnerabilityItems": [],
    "caseReferences": [],
    "caseStatuses": [
      {
        "id": "urn:uuid:3046e666-a79a-45b5-8a38-f3b5ed0950ed",
        "type": "CaseStatus",
        "name": "NONE pxa",
        "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
        "published": "2026-06-01T19:12:00.000000+00:00",
        "attributedTo": "https://vultron.example/organizations/vendorco",
        "emState": "NONE",
        "pxaState": "pxa"
      }
    ],
    "notes": [],
    "embargoRegister": [],
    "pendingEmbargoProposalIndex": {},
    "caseActivity": [],
    "genesisHash": "41ebcb1d996477859b8fec00382f75af72401ede0814022bab3f0d54f1b25e0d",
    "ledgerPosition": {
      "logIndex": -1,
      "entryHash": "41ebcb1d996477859b8fec00382f75af72401ede0814022bab3f0d54f1b25e0d"
    },
    "parentCases": [],
    "childCases": [],
    "siblingCases": [],
    "activeParticipants": []
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/case-actors/vendorco-case-actor#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z5dkCbouVk3djURcvnvoR5Wx3YdWycTgnQMMsfugutpbXVChm12EzqZvx4ERDyCMXWoTX9uNWrKmiLca7A4mn835q"
  }
}
  • Protocol role: every change the CASE_MANAGER makes to the case file is its own ledger entry (CLP-07-013). An Update carrying the case in full is the shape that such an entry takes for a change to a case field. The prototype commits one such entry, update_case_owner, when an ownership transfer changes the Case Owner (CM-21-024), and replicas copy it from the ledger fan-out (§10.2 Routing Topology). A participant that wants a change made asks the CASE_MANAGER. It does not send Update to the CASE_MANAGER or to its peers.
  • On receipt: the activity is recognized, but no use case handles it, so an inbox reports "no use case found" and changes nothing.
  • Triggering transition: none — metadata change, not a state transition.

Add vulnerability item to case

Carries the item in full, with the case as its target. At a case's creation it follows the genesis entry.

  • When… the CASE_MANAGER brings a vulnerability item into a case, such as one a new case takes from its CSAF report
  • Send: Add(VulnerabilityItem)[target=VulnerabilityCase]
  • Send to: a participant
  • Sent by: internal to the CASE_MANAGER
  • Mapping status: none

Each participant learns of it from the case ledger, so it is addressed to nobody.

{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Add",
  "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/items/1/add",
  "name": "https://vultron.example/case-actors/vendorco-case-actor Add urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/items/1 to urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "actor": "https://vultron.example/case-actors/vendorco-case-actor",
  "target": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "object": {
    "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/items/1",
    "type": "VulnerabilityItem",
    "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "ids": [
      {
        "systemName": "CVE",
        "text": "CVE-2026-0001"
      }
    ],
    "title": "Buffer overflow in the widget parser",
    "notes": [],
    "references": []
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/case-actors/vendorco-case-actor#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z4aTGyyt4BqkLB5yuxSGvsZrzreFmDE2Ku8ABP9YcLV3AuT2CXPE1pAgVz7r4GcziQ2rCmx6bLFzLNw1BJ1nrSx45"
  }
}
  • Protocol role: the CASE_MANAGER records each vulnerability item it brings into a case as its own entry, an Add carrying the item in full with the case as its target (CLP-07-021). The case lists its items, so the one Add both brings the item and lists it. A case created from a CSAF report takes one for each vulnerability the report names (CSAF-03-008), after the case's genesis entry. Replicas copy the item from the ledger fan-out (§10.2 Routing Topology).
  • On receipt: the activity is recognized, but no use case handles it, so an inbox reports "no use case found" and changes nothing.
  • Triggering transition: none — the case's content changes.

Add case reference to case

Carries the reference in full, with the case as its target. At a case's creation it follows the genesis entry.

  • When… the CASE_MANAGER brings a case reference into a case, such as one a new case takes from its CSAF report
  • Send: Add(CaseReference)[target=VulnerabilityCase]
  • Send to: a participant
  • Sent by: internal to the CASE_MANAGER
  • Mapping status: none

Each participant learns of it from the case ledger, so it is addressed to nobody.

{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Add",
  "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/references/1/add",
  "name": "https://vultron.example/case-actors/vendorco-case-actor Add Vendor advisory to urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "actor": "https://vultron.example/case-actors/vendorco-case-actor",
  "target": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "object": {
    "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/references/1",
    "type": "CaseReference",
    "name": "Vendor advisory",
    "url": {
      "type": "Link",
      "href": "https://example.org/advisories/widget-overflow",
      "rel": []
    },
    "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00"
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/case-actors/vendorco-case-actor#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "zVLmV47QEKAGi8HsdPW1XKPrQaZwGLwzQjQpawByYhjeC1Wn2jFqcwojn6sb9PjPytDoJhfibr2hdHmi9Ssnbxjo"
  }
}
  • Protocol role: the CASE_MANAGER records each case reference it brings into a case the same way, an Add carrying the reference in full with the case as its target (CLP-07-021). A case created from a CSAF report takes one for each of the report's document-level references (CSAF-03-009). A vulnerability's own references stay on its item.
  • On receipt: the activity is recognized, but no use case handles it, so an inbox reports "no use case found" and changes nothing.
  • Triggering transition: none — the case's content changes.

Create case participant

Carries the new participant record in full: its roles, statuses, joined mark and consent rows.

  • When… the CASE_MANAGER creates a participant record, such as the inert record for the invitee of a stub Invite
  • Send: Create(CaseParticipant)
  • Send to: a participant
  • Sent by: internal to the CASE_MANAGER
  • Mapping status: none

Each participant learns of it from the case ledger, so it is addressed to nobody.

{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Create",
  "id": "urn:uuid:19f8ed08-881b-4ffb-a326-af232e51dd50",
  "name": "https://vultron.example/case-actors/vendorco-case-actor Create as_CaseParticipant urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/participants/https://vultron.example/organizations/coordinator from https://vultron.example/organizations/coordinator in urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "actor": "https://vultron.example/case-actors/vendorco-case-actor",
  "target": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "object": {
    "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/participants/https://vultron.example/organizations/coordinator",
    "type": "CaseParticipant",
    "name": "Coordinator LLC",
    "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "attributedTo": "https://vultron.example/organizations/coordinator",
    "caseRoles": [
      "coordinator"
    ],
    "participantStatuses": [
      {
        "id": "urn:uuid:5335cd02-4367-4a21-afbb-980beee3ef63",
        "type": "ParticipantStatus",
        "name": "START",
        "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
        "published": "2026-06-01T19:12:00.000000+00:00",
        "updated": "2026-06-01T19:12:00.000000+00:00",
        "attributedTo": "https://vultron.example/organizations/coordinator",
        "rmState": "START",
        "caseEngagement": true,
        "cvdRole": [
          "COORDINATOR"
        ]
      }
    ],
    "embargoConsents": [],
    "joined": true
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/case-actors/vendorco-case-actor#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z67D69F7x3nvURmLk3aP9iMiERx2zhr4EvkLrQHS6TZWBuTLDp6Rni6MyKX69X7GyMuywUrsmimvUERFWhPNE1XsG"
  }
}
  • Protocol role: a participant record comes into existence only as the CASE_MANAGER's consequence of an act it records (ADR-0137, VAM-01-020). The CASE_MANAGER creates the invitee's participant record when it sends a stub Invite, and commits that creation as its own entry, carrying the record in full (CLP-07-021). Replicas copy the record from the ledger fan-out (§10.2 Routing Topology). An actor joins a case by accepting its stub Invite (see Accept Invite to Case).
  • On receipt: the activity is recognized, but no use case handles it, so an inbox reports "no use case found" and changes nothing (VAM-01-018).
  • Triggering transition: none — object construction.

Update case participant

Carries the changed participant record in full, as the CASE_MANAGER stored it.

  • When… the CASE_MANAGER changes a participant record, such as moving the CASE_OWNER role on an ownership transfer
  • Send: Update(CaseParticipant)
  • Send to: a participant
  • Sent by: internal to the CASE_MANAGER
  • Mapping status: none

Each participant learns of it from the case ledger, so it is addressed to nobody.

{
  "@context": [
    "https://www.w3.org/ns/activitystreams",
    "https://certcc.github.io/Vultron/ns/context.jsonld",
    "https://w3id.org/security/data-integrity/v2"
  ],
  "type": "Update",
  "id": "urn:uuid:bba303c5-61c3-4502-984e-c9104a1380d1",
  "name": "https://vultron.example/case-actors/vendorco-case-actor Update Coordinator LLC",
  "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
  "published": "2026-06-01T19:12:00.000000+00:00",
  "updated": "2026-06-01T19:12:00.000000+00:00",
  "actor": "https://vultron.example/case-actors/vendorco-case-actor",
  "object": {
    "id": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a/participants/https://vultron.example/organizations/coordinator",
    "type": "CaseParticipant",
    "name": "Coordinator LLC",
    "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
    "published": "2026-06-01T19:12:00.000000+00:00",
    "updated": "2026-06-01T19:12:00.000000+00:00",
    "attributedTo": "https://vultron.example/organizations/coordinator",
    "caseRoles": [
      "coordinator",
      "case_owner"
    ],
    "participantStatuses": [
      {
        "id": "urn:uuid:e1af94ca-c302-46df-9313-495501f9ec4f",
        "type": "ParticipantStatus",
        "name": "START",
        "context": "urn:uuid:e54656f1-e9c8-4ec5-9a69-6cbf725e510a",
        "published": "2026-06-01T19:12:00.000000+00:00",
        "updated": "2026-06-01T19:12:00.000000+00:00",
        "attributedTo": "https://vultron.example/organizations/coordinator",
        "rmState": "START",
        "caseEngagement": true,
        "cvdRole": [
          "COORDINATOR"
        ]
      }
    ],
    "embargoConsents": [],
    "joined": true
  },
  "proof": {
    "@context": [
      "https://www.w3.org/ns/activitystreams",
      "https://certcc.github.io/Vultron/ns/context.jsonld",
      "https://w3id.org/security/data-integrity/v2"
    ],
    "type": "DataIntegrityProof",
    "cryptosuite": "eddsa-jcs-2022",
    "verificationMethod": "https://vultron.example/case-actors/vendorco-case-actor#main-key",
    "proofPurpose": "assertionMethod",
    "created": "2026-06-01T19:12:00.000000+00:00",
    "proofValue": "z34HciGz3HDA6k76Smqf3ofJvK8gisC2XSmqgiYL3kxNNmbVmBrPf6SfMMVCmaqKeSeLA9GkdfXuPizKZcfUfTRZP"
  }
}
  • Protocol role: the CASE_MANAGER commits each participant record it changes as its own entry, after the act that caused the change (CLP-07-013). An ownership transfer moves the CASE_OWNER role this way, one entry for each record that changed (CM-21-002). Replicas store the record as the CASE_MANAGER stored it.
  • On receipt: the activity is recognized, but no use case handles it, so an inbox reports "no use case found" and changes nothing.
  • Triggering transition: none — the record changes as the act's consequence.