Show/hide List Operations Expand Operations

1. Tensions API

GET /api/organizations/{organization_id}/node-tensions

Displays tensions

Documentation
Sandbox

Requirements

Name	Requirement	Type	Description
organization_id

Status Codes

Status Code	Description
200
401	Unauthorized (i.e. OAuth2 authentication required)

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

GET /api/organizations/{organization_id}/tensions

Displays tensions

Documentation
Sandbox

Requirements

Name	Requirement	Type	Description
organization_id

Status Codes

Status Code	Description
200
401	Unauthorized (i.e. OAuth2 authentication required)

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

POST /api/organizations/{organization_id}/tensions

Creates a tension

Documentation
Sandbox

Requirements

Name	Requirement	Type	Description
organization_id

Parameters

Parameter	Type	Required?	Format	Description
meeting	string	true		The meeting we attach the tension to.
name	string	true
body	string	false
status	choice	false	["draft","ready","archived","attached","gog","objected","rejected","accepted","stalled"]
isDraft	boolean	true
proposals	string	false
meetingTemplate	string	false
member	string	false
reportMeeting	string	false
reportTension	string	false
reportRole	string	false
circle	string	true
tensionBehavior	choice	true	["proposal","note"]
importInMeeting	boolean	true
absolutePosition	integer	true

Status Codes

Status Code	Description
201	Tension is created
400	Validations errors
401	Unauthorized (i.e. OAuth2 authentication required)

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

POST /api/organizations/{organization_id}/tensions/duplicate

Duplicate a tension

Documentation
Sandbox

Requirements

Name	Requirement	Type	Description
organization_id

Parameters

Parameter	Type	Required?	Format	Description
id	string	true
name	string	true

Status Codes

Status Code	Description
201	Tension is duplicate
400	Validations errors
401	Unauthorized (i.e. OAuth2 authentication required)

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

DELETE /api/organizations/{organization_id}/tensions/{tension_id}

Deletes a tension

Documentation
Sandbox

Requirements

Name	Requirement	Type	Description
organization_id
tension_id

Parameters

Parameter	Type	Required?	Format	Description
reportMeeting	string	false

Status Codes

Status Code	Description
204	Tension is deleted
400	The tension status is invalid
401	Unauthorized (i.e. OAuth2 authentication required)

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

GET /api/organizations/{organization_id}/tensions/{tension_id}

Displays a tension

Documentation
Sandbox

Requirements

Name	Requirement	Type	Description
organization_id
tension_id

Status Codes

Status Code	Description
200
401	Unauthorized (i.e. OAuth2 authentication required)

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

PATCH /api/organizations/{organization_id}/tensions/{tension_id}

Updates a tension (some fields)

Documentation
Sandbox

Requirements

Name	Requirement	Type	Description
organization_id
tension_id

Parameters

Parameter	Type	Required?	Format
name	string	false
isDraft	boolean	false
body	string	false
status	choice	false	["draft","ready","archived","attached","gog","objected","rejected","accepted","stalled"]
meetingTemplate	string	false
proposals	string	false
circle	string	false
member	string	false
tensionBehavior	choice	false	["proposal","note"]
importInMeeting	boolean	false

Status Codes

Status Code	Description
200	Tension is updated
400	Validations errors
401	Unauthorized (i.e. OAuth2 authentication required)

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

POST /api/organizations/{organization_id}/tensions/{tension_id}/comment

Creates a tension comment

Documentation
Sandbox

Requirements

Name	Requirement	Type	Description
organization_id
tension_id

Parameters

Parameter	Type	Required?	Format	Description
comment	string	true
step	string	true		For meetings only

Status Codes

Status Code	Description
201	Tension comment is created
400	Validations errors
401	Unauthorized (i.e. OAuth2 authentication required)

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

GET /api/organizations/{organization_id}/tensions/{tension_id}/feed

Displays a tension feed

Documentation
Sandbox

Requirements

Name	Requirement	Type	Description
organization_id
tension_id

Status Codes

Status Code	Description
200
401	Unauthorized (i.e. OAuth2 authentication required)

Input

Requirements

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

POST /api/organizations/{organization_id}/tensions/{tension_id}/meetings

Attach/Detach a tension and a meeting

Documentation
Sandbox

Requirements

Name	Requirement	Type	Description
organization_id
tension_id

Parameters

Parameter	Type	Required?	Format	Description
meeting	string	true		The meeting we attach the tension to.
status	string	true		Deprecated: do not use

Status Codes

Status Code	Description
200	Tension is attached/detached
400	Validations errors
401	Unauthorized (i.e. OAuth2 authentication required)

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

POST /api/organizations/{organization_id}/tensions/{tension_id}/positions

Update the position of a tension

Documentation
Sandbox

Requirements

Name	Requirement	Type	Description
organization_id
tension_id

Parameters

Parameter	Type	Required?	Format	Description
absolutePosition	integer	true
meetingPosition	integer	true

Status Codes

Status Code	Description
200	Tension's position is updated
400	Validations errors
401	Unauthorized (i.e. OAuth2 authentication required)

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

Show/hide List Operations Expand Operations

2. Governances out of Governance votes API

POST /api/organizations/{organization_id}/gogs/{tension_id}/vote

Vote for a Governance out of Governance

Documentation
Sandbox

Requirements

Name	Requirement	Type	Description
organization_id
tension_id

Parameters

Parameter	Type	Required?	Format	Description
vote	choice	true	["abstention","objected","validated"]
reason	string	true		Reason is only allowed when objecting.

Status Codes

Status Code	Description
201	Vote is created
400	Validations errors
401	Unauthorized (i.e. OAuth2 authentication required)

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

Show/hide List Operations Expand Operations

3. Transform tension API

POST /api/organizations/{organization_id}/tensions/{tension_id}/transform/board

Transform tension to board

Documentation
Sandbox

Requirements

Name	Requirement	Type	Description
organization_id
tension_id

Parameters

Parameter	Type	Required?	Format
title	string	true
administrators[]	array of objects (MemberSelectorType)	false
completedColumn	string	false
private	boolean	false
context	object (ContextType)	true
context[funnels][]	array of objects (ContextFunnelType)	false
context[funnels][][isSync]	boolean	true
context[funnels][][circle]	string	false
context[funnels][][role]	string	false
context[funnels][][members][]	array of objects (MemberSelectorType)	false
status	choice	true	["current","done"]
allowColumnUpdate	choice	true	["admin","all"]
contextAssigner	choice	true	["admin","all"]
reportMeeting	string	false
reportTension	string	false

Status Codes

Status Code	Description
201	Tension is transform to board
400	Validations errors
401	Unauthorized (i.e. OAuth2 authentication required)

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

POST /api/organizations/{organization_id}/tensions/{tension_id}/transform/okr

Transform tension to okr

Documentation
Sandbox

Requirements

Name	Requirement	Type	Description
organization_id
tension_id

Parameters

Parameter	Type	Required?	Format
circle	string	true
periodStartAt	datetime	true	yyyy-MM-dd'T'HH:mm:ss
timeframe	string	true
title	string	true

Status Codes

Status Code	Description
201	Tension is transform to objective
400	Validations errors
401	Unauthorized (i.e. OAuth2 authentication required)

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

POST /api/organizations/{organization_id}/tensions/{tension_id}/transform/task

Transform tension to task

Documentation
Sandbox

Requirements

Name	Requirement	Type	Description
organization_id
tension_id

Parameters

Parameter	Type	Required?
title	string	true
circle	string	false
board	string	false
column	string	false
parentTask	string	false

Status Codes

Status Code	Description
201	Tension is transform to task
400	Validations errors
401	Unauthorized (i.e. OAuth2 authentication required)

Input

Requirements

= -

Parameters

= -

Headers

= -

Content

= Replaces header if set

Holaspirit API documentation

1. Tensions API

GET /api/organizations/{organization_id}/node-tensions

Requirements

Status Codes

Requirements

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

GET /api/organizations/{organization_id}/tensions

Requirements

Status Codes

Requirements

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

POST /api/organizations/{organization_id}/tensions

Requirements

Parameters

Status Codes

Requirements

Parameters

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

POST /api/organizations/{organization_id}/tensions/duplicate

Requirements

Parameters

Status Codes

Requirements

Parameters

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

DELETE /api/organizations/{organization_id}/tensions/{tension_id}

Requirements

Parameters

Status Codes

Requirements

Parameters

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

GET /api/organizations/{organization_id}/tensions/{tension_id}

Requirements

Status Codes

Requirements

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

PATCH /api/organizations/{organization_id}/tensions/{tension_id}

Requirements

Parameters

Status Codes

Requirements

Parameters

Request URL

Request body

Response Headers [Expand] [Profiler]

Response Body [Raw]

Curl Command Line

POST /api/organizations/{organization_id}/tensions/{tension_id}/comment

Requirements

Parameters

Status Codes

Requirements

Parameters

Request URL