Skip to content
MereonMereonMereon Docs

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

Section titled “Get duties for an entity”

GET /v1/duties

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

Query parameters

Section titled “Query parameters”
Parameter Type Notes
entityType string One of TOPIC, ITEM, SPACE, CATEGORY. Required.
entityId string The entity’s id. Required.

Request

Section titled “Request”
Terminal window
curl "https://api.mereon.ai/v1/duties?entityType=TOPIC&entityId=top_9f2a" \
  -H "Authorization: Bearer $MEREON_TOKEN"

Response

Section titled “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

Section titled “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.