Duties

Duties answer “who owns this”. Mereon tracks ownership using the RACI model: who is Responsible, Accountable, Consulted, or Informed for a topic, item, space, or category. Duties can be assigned directly or inherited from a parent area.

Get duties for an entity

GET /v1/duties

Returns the effective duties for one entity, including inherited ones.

Query parameters

Parameter	Type	Notes
`entityType`	string	One of `TOPIC`, `ITEM`, `SPACE`, `CATEGORY`. Required.
`entityId`	string	The entity’s id. Required.

Request

curl "https://api.mereon.ai/v1/duties?entityType=TOPIC&entityId=top_9f2a" \
  -H "Authorization: Bearer $MEREON_TOKEN"

Response

{
  "data": [
    {
      "role": "ACCOUNTABLE",
      "actorType": "USER",
      "actorId": "usr_8s2k...",
      "actorDisplayName": "Alex Doe",
      "inheritedFrom": null
    },
    {
      "role": "CONSULTED",
      "actorType": "ROLE",
      "actorId": "rol_1122...",
      "actorDisplayName": "Finance Manager",
      "inheritedFrom": { "entityType": "CATEGORY", "entityId": "cat_finance" }
    }
  ]
}

Fields

Field	Type	Notes
`role`	string	`RESPONSIBLE`, `ACCOUNTABLE`, `CONSULTED`, or `INFORMED`.
`actorType`	string	What kind of actor holds the duty, for example a user or a role.
`actorId`	string	The actor’s id.
`actorDisplayName`	string	Human-readable name of the actor.
`inheritedFrom`	object \| null	The parent entity the duty was inherited from, or `null` if assigned directly.