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. Reading them needs the raci-assignment.read permission, which every role has except external; an external account gets 403, as it does in the app.

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": "INDIVIDUAL",
      "actorId": "emp_7c41...",
      "actorUserId": "usr_8s2k...",
      "actorDisplayName": "Alex Doe",
      "inheritedFrom": null,
      "assignmentId": "ras_71b3...",
      "source": "MANUAL",
      "confidence": null,
      "learningPriorityOverride": null
    },
    {
      "role": "CONSULTED",
      "actorType": "ROLE",
      "actorId": "rol_1122...",
      "actorUserId": null,
      "actorDisplayName": "Finance Manager",
      "inheritedFrom": { "entityType": "CATEGORY", "entityId": "cat_finance" },
      "assignmentId": "ras_0d92...",
      "source": "AI_ENHANCED",
      "confidence": 0.82,
      "learningPriorityOverride": "HIGH"
    }
  ]
}

Fields

Section titled “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.
assignmentId string The assignment behind this duty. For an inherited duty it is the parent’s assignment, not one on the entity you asked about.
source string Who set the duty: MANUAL for a person’s own assignment, or AI_ENHANCED or AI_CLASSIFIED for the system’s suggestion. Most owners are suggestions, so this is what separates a confirmed owner from a proposed one.
confidence number | null How sure the suggestion was, from 0 to 1. null for a person’s own assignment.
learningPriorityOverride string | null This duty’s own learning priority (CRITICAL, HIGH, MEDIUM, or LOW). null means the topic’s priority applies.