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": "INDIVIDUAL",
      "actorId": "emp_7c41...",
      "actorUserId": "usr_8s2k...",
      "actorDisplayName": "Alex Doe",
      "inheritedFrom": null
    },
    {
      "role": "CONSULTED",
      "actorType": "ROLE",
      "actorId": "rol_1122...",
      "actorUserId": null,
      "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: `INDIVIDUAL`, `TEAM`, `ROLE`, `THIRD_PARTY`, `ORGANIZATION`, or `ROLE_KIND`.
`actorId`	string	The actor’s id. For `INDIVIDUAL` this identifies the organization’s record of the person, not their login. The same person has a different record in each organization they belong to.
`actorUserId`	string \| null	The login behind an `INDIVIDUAL` actor, which is the id you will find on user-keyed resources. `null` for every other actor type, and for a person the organization records without an account.
`actorDisplayName`	string	Human-readable name of the actor.
`inheritedFrom`	object \| null	The parent entity the duty was inherited from, or `null` if assigned directly.