Skip to content
Portuni

Responsibilities

Responsibilities are units of work attached to project, process, or area nodes. Data sources and tools are descriptive metadata listing what a node reads from and what it uses. See Actors & Responsibilities for the conceptual model.

portuni_create_responsibility

Section titled “portuni_create_responsibility”

Create a responsibility on a node. Optionally assign initial actors in the same call.

ParameterTypeRequiredDescription
node_idstringyesProject, process, or area to attach to
titlestringyesShort title
descriptionstringnoLonger explanation
sort_ordernumbernoPosition in the list (lower = higher priority). Defaults to end-of-list
assignee_actor_idsstring[]noActors to assign on creation

Returns: { responsibility_id, node_id, title, sort_order, assignees }

portuni_update_responsibility

Section titled “portuni_update_responsibility”
ParameterTypeRequiredDescription
responsibility_idstringyesResponsibility ID
titlestringnoNew title
descriptionstringnoNew description
sort_ordernumbernoNew position

Assignments are managed separately via portuni_assign_responsibility and portuni_unassign_responsibility.

portuni_delete_responsibility

Section titled “portuni_delete_responsibility”

Delete a responsibility. Cascades to assignments – the actors stay, the assignment records are removed.

ParameterTypeRequiredDescription
responsibility_idstringyesResponsibility ID

portuni_list_responsibilities

Section titled “portuni_list_responsibilities”

List responsibilities, optionally filtered.

ParameterTypeRequiredDescription
node_idstringnoFilter to one node
actor_idstringnoFilter to responsibilities assigned to one actor

Returns: array of responsibility records, each with its assignees (actor IDs and names).

Data sources and tools

Section titled “Data sources and tools”

Two parallel attribute lists hang off project / process / area nodes.

portuni_add_data_source

Section titled “portuni_add_data_source”
ParameterTypeRequiredDescription
node_idstringyesProject, process, or area
namestringyesDisplay name (e.g. “Workflow CRM segment: VIP partners”)
kindstringnoFree-form classification (e.g. crm, bigquery, report, airtable)
external_linkstringnoURL to the source. Plain URL only – never include credentials

portuni_remove_data_source

Section titled “portuni_remove_data_source”
ParameterTypeRequiredDescription
data_source_idstringyesData source ID

portuni_list_data_sources

Section titled “portuni_list_data_sources”
ParameterTypeRequiredDescription
node_idstringyesNode to list for

portuni_add_tool

Section titled “portuni_add_tool”
ParameterTypeRequiredDescription
node_idstringyesProject, process, or area
namestringyesDisplay name (e.g. “Asana”, “Figma”)
external_linkstringnoURL or identifier

portuni_remove_tool

Section titled “portuni_remove_tool”
ParameterTypeRequiredDescription
tool_idstringyesTool ID

portuni_list_tools

Section titled “portuni_list_tools”
ParameterTypeRequiredDescription
node_idstringyesNode to list for

See also

Section titled “See also”