curl --request POST \
--url https://app.orgo.space/api/v1/discussions \
--header 'Api-Token: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "Volunteer Coordinator",
"unit": "/api/v1/units/1",
"isReadOnly": true,
"namespace": "/api/v1/discussion_namespaces/1",
"assignee": "/api/v1/users/1",
"priority": 42,
"position": 42,
"isArchived": false,
"isSupport": true,
"supportMetadata": "string",
"supportAnonymous": [
"string"
],
"isIssue": true,
"issueStatus": "/api/v1/issue_statuses/1",
"issueType": "/api/v1/issue_types/1",
"dueDate": "2026-01-15T10:30:00+00:00",
"issueBoardPosition": 42,
"issueStatusPosition": 42
}
'import requests
url = "https://app.orgo.space/api/v1/discussions"
payload = {
"title": "Volunteer Coordinator",
"unit": "/api/v1/units/1",
"isReadOnly": True,
"namespace": "/api/v1/discussion_namespaces/1",
"assignee": "/api/v1/users/1",
"priority": 42,
"position": 42,
"isArchived": False,
"isSupport": True,
"supportMetadata": "string",
"supportAnonymous": ["string"],
"isIssue": True,
"issueStatus": "/api/v1/issue_statuses/1",
"issueType": "/api/v1/issue_types/1",
"dueDate": "2026-01-15T10:30:00+00:00",
"issueBoardPosition": 42,
"issueStatusPosition": 42
}
headers = {
"Api-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Api-Token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
title: 'Volunteer Coordinator',
unit: '/api/v1/units/1',
isReadOnly: true,
namespace: '/api/v1/discussion_namespaces/1',
assignee: '/api/v1/users/1',
priority: 42,
position: 42,
isArchived: false,
isSupport: true,
supportMetadata: 'string',
supportAnonymous: ['string'],
isIssue: true,
issueStatus: '/api/v1/issue_statuses/1',
issueType: '/api/v1/issue_types/1',
dueDate: '2026-01-15T10:30:00+00:00',
issueBoardPosition: 42,
issueStatusPosition: 42
})
};
fetch('https://app.orgo.space/api/v1/discussions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.orgo.space/api/v1/discussions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'title' => 'Volunteer Coordinator',
'unit' => '/api/v1/units/1',
'isReadOnly' => true,
'namespace' => '/api/v1/discussion_namespaces/1',
'assignee' => '/api/v1/users/1',
'priority' => 42,
'position' => 42,
'isArchived' => false,
'isSupport' => true,
'supportMetadata' => 'string',
'supportAnonymous' => [
'string'
],
'isIssue' => true,
'issueStatus' => '/api/v1/issue_statuses/1',
'issueType' => '/api/v1/issue_types/1',
'dueDate' => '2026-01-15T10:30:00+00:00',
'issueBoardPosition' => 42,
'issueStatusPosition' => 42
]),
CURLOPT_HTTPHEADER => [
"Api-Token: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.orgo.space/api/v1/discussions"
payload := strings.NewReader("{\n \"title\": \"Volunteer Coordinator\",\n \"unit\": \"/api/v1/units/1\",\n \"isReadOnly\": true,\n \"namespace\": \"/api/v1/discussion_namespaces/1\",\n \"assignee\": \"/api/v1/users/1\",\n \"priority\": 42,\n \"position\": 42,\n \"isArchived\": false,\n \"isSupport\": true,\n \"supportMetadata\": \"string\",\n \"supportAnonymous\": [\n \"string\"\n ],\n \"isIssue\": true,\n \"issueStatus\": \"/api/v1/issue_statuses/1\",\n \"issueType\": \"/api/v1/issue_types/1\",\n \"dueDate\": \"2026-01-15T10:30:00+00:00\",\n \"issueBoardPosition\": 42,\n \"issueStatusPosition\": 42\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Api-Token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.orgo.space/api/v1/discussions")
.header("Api-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"Volunteer Coordinator\",\n \"unit\": \"/api/v1/units/1\",\n \"isReadOnly\": true,\n \"namespace\": \"/api/v1/discussion_namespaces/1\",\n \"assignee\": \"/api/v1/users/1\",\n \"priority\": 42,\n \"position\": 42,\n \"isArchived\": false,\n \"isSupport\": true,\n \"supportMetadata\": \"string\",\n \"supportAnonymous\": [\n \"string\"\n ],\n \"isIssue\": true,\n \"issueStatus\": \"/api/v1/issue_statuses/1\",\n \"issueType\": \"/api/v1/issue_types/1\",\n \"dueDate\": \"2026-01-15T10:30:00+00:00\",\n \"issueBoardPosition\": 42,\n \"issueStatusPosition\": 42\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/discussions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Api-Token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"Volunteer Coordinator\",\n \"unit\": \"/api/v1/units/1\",\n \"isReadOnly\": true,\n \"namespace\": \"/api/v1/discussion_namespaces/1\",\n \"assignee\": \"/api/v1/users/1\",\n \"priority\": 42,\n \"position\": 42,\n \"isArchived\": false,\n \"isSupport\": true,\n \"supportMetadata\": \"string\",\n \"supportAnonymous\": [\n \"string\"\n ],\n \"isIssue\": true,\n \"issueStatus\": \"/api/v1/issue_statuses/1\",\n \"issueType\": \"/api/v1/issue_types/1\",\n \"dueDate\": \"2026-01-15T10:30:00+00:00\",\n \"issueBoardPosition\": 42,\n \"issueStatusPosition\": 42\n}"
response = http.request(request)
puts response.read_body{
"id": 42,
"title": "Volunteer Coordinator",
"content": "<p>Hello {{firstName}},</p><p>You're invited.</p>",
"mainPost": {
"id": 42,
"owner": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"fullName": "James Patterson",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png"
},
"childrenCount": 12,
"dateCreated": "2026-01-15T10:30:00+00:00",
"mentions": [
{
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"fullName": "James Patterson",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png"
}
],
"content": "<p>Hello {{firstName}},</p><p>You're invited.</p>",
"reactionData": [
"string"
],
"myReactions": [
"string"
],
"embedOpenGraph": {
"id": 42,
"url": "https://civic-collective.example.com/agm",
"openGraph": [
"string"
]
},
"medias": [
{
"id": 42,
"size": 42,
"entityId": 42,
"contentUrl": "https://civic-collective.example.com",
"type": "MEMBER",
"mimeType": "application/pdf",
"originalName": "Boston Chapter"
}
],
"isDeleted": false,
"moderated": "/api/v1/logs/1",
"parentId": 42
},
"postsCount": 12,
"unit": {
"id": 42,
"name": "Boston Chapter"
},
"isReadOnly": true,
"topics": [
{
"id": 42,
"name": "Boston Chapter",
"type": "/api/v1/topic_types/1"
}
],
"namespace": {
"id": 42,
"name": "Boston Chapter"
},
"assignee": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"fullName": "James Patterson",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png"
},
"priority": 42,
"position": 42,
"isArchived": false,
"isSupport": true,
"supportMetadata": "string",
"supportAnonymous": [
"string"
],
"isIssue": true,
"issueStatus": {
"id": 42,
"name": "Boston Chapter",
"color": "#16A34A"
},
"issueType": {
"id": 42,
"name": "Boston Chapter",
"color": "#16A34A"
},
"dueDate": "2026-01-15T10:30:00+00:00",
"viewsCount": 12,
"reactionsCount": 12,
"issueBoardPosition": 42,
"issueStatusPosition": 42
}Create a discussion
Creates a new discussion with a main post. Sets the current user as owner, creates an initial view record, sends mention notifications to any users mentioned in the main post body, and auto-assigns issues to the default assignee when applicable. Also updates tenant onboarding progress.
curl --request POST \
--url https://app.orgo.space/api/v1/discussions \
--header 'Api-Token: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"title": "Volunteer Coordinator",
"unit": "/api/v1/units/1",
"isReadOnly": true,
"namespace": "/api/v1/discussion_namespaces/1",
"assignee": "/api/v1/users/1",
"priority": 42,
"position": 42,
"isArchived": false,
"isSupport": true,
"supportMetadata": "string",
"supportAnonymous": [
"string"
],
"isIssue": true,
"issueStatus": "/api/v1/issue_statuses/1",
"issueType": "/api/v1/issue_types/1",
"dueDate": "2026-01-15T10:30:00+00:00",
"issueBoardPosition": 42,
"issueStatusPosition": 42
}
'import requests
url = "https://app.orgo.space/api/v1/discussions"
payload = {
"title": "Volunteer Coordinator",
"unit": "/api/v1/units/1",
"isReadOnly": True,
"namespace": "/api/v1/discussion_namespaces/1",
"assignee": "/api/v1/users/1",
"priority": 42,
"position": 42,
"isArchived": False,
"isSupport": True,
"supportMetadata": "string",
"supportAnonymous": ["string"],
"isIssue": True,
"issueStatus": "/api/v1/issue_statuses/1",
"issueType": "/api/v1/issue_types/1",
"dueDate": "2026-01-15T10:30:00+00:00",
"issueBoardPosition": 42,
"issueStatusPosition": 42
}
headers = {
"Api-Token": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Api-Token': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
title: 'Volunteer Coordinator',
unit: '/api/v1/units/1',
isReadOnly: true,
namespace: '/api/v1/discussion_namespaces/1',
assignee: '/api/v1/users/1',
priority: 42,
position: 42,
isArchived: false,
isSupport: true,
supportMetadata: 'string',
supportAnonymous: ['string'],
isIssue: true,
issueStatus: '/api/v1/issue_statuses/1',
issueType: '/api/v1/issue_types/1',
dueDate: '2026-01-15T10:30:00+00:00',
issueBoardPosition: 42,
issueStatusPosition: 42
})
};
fetch('https://app.orgo.space/api/v1/discussions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.orgo.space/api/v1/discussions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'title' => 'Volunteer Coordinator',
'unit' => '/api/v1/units/1',
'isReadOnly' => true,
'namespace' => '/api/v1/discussion_namespaces/1',
'assignee' => '/api/v1/users/1',
'priority' => 42,
'position' => 42,
'isArchived' => false,
'isSupport' => true,
'supportMetadata' => 'string',
'supportAnonymous' => [
'string'
],
'isIssue' => true,
'issueStatus' => '/api/v1/issue_statuses/1',
'issueType' => '/api/v1/issue_types/1',
'dueDate' => '2026-01-15T10:30:00+00:00',
'issueBoardPosition' => 42,
'issueStatusPosition' => 42
]),
CURLOPT_HTTPHEADER => [
"Api-Token: <api-key>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.orgo.space/api/v1/discussions"
payload := strings.NewReader("{\n \"title\": \"Volunteer Coordinator\",\n \"unit\": \"/api/v1/units/1\",\n \"isReadOnly\": true,\n \"namespace\": \"/api/v1/discussion_namespaces/1\",\n \"assignee\": \"/api/v1/users/1\",\n \"priority\": 42,\n \"position\": 42,\n \"isArchived\": false,\n \"isSupport\": true,\n \"supportMetadata\": \"string\",\n \"supportAnonymous\": [\n \"string\"\n ],\n \"isIssue\": true,\n \"issueStatus\": \"/api/v1/issue_statuses/1\",\n \"issueType\": \"/api/v1/issue_types/1\",\n \"dueDate\": \"2026-01-15T10:30:00+00:00\",\n \"issueBoardPosition\": 42,\n \"issueStatusPosition\": 42\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Api-Token", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.orgo.space/api/v1/discussions")
.header("Api-Token", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"Volunteer Coordinator\",\n \"unit\": \"/api/v1/units/1\",\n \"isReadOnly\": true,\n \"namespace\": \"/api/v1/discussion_namespaces/1\",\n \"assignee\": \"/api/v1/users/1\",\n \"priority\": 42,\n \"position\": 42,\n \"isArchived\": false,\n \"isSupport\": true,\n \"supportMetadata\": \"string\",\n \"supportAnonymous\": [\n \"string\"\n ],\n \"isIssue\": true,\n \"issueStatus\": \"/api/v1/issue_statuses/1\",\n \"issueType\": \"/api/v1/issue_types/1\",\n \"dueDate\": \"2026-01-15T10:30:00+00:00\",\n \"issueBoardPosition\": 42,\n \"issueStatusPosition\": 42\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.orgo.space/api/v1/discussions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Api-Token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"Volunteer Coordinator\",\n \"unit\": \"/api/v1/units/1\",\n \"isReadOnly\": true,\n \"namespace\": \"/api/v1/discussion_namespaces/1\",\n \"assignee\": \"/api/v1/users/1\",\n \"priority\": 42,\n \"position\": 42,\n \"isArchived\": false,\n \"isSupport\": true,\n \"supportMetadata\": \"string\",\n \"supportAnonymous\": [\n \"string\"\n ],\n \"isIssue\": true,\n \"issueStatus\": \"/api/v1/issue_statuses/1\",\n \"issueType\": \"/api/v1/issue_types/1\",\n \"dueDate\": \"2026-01-15T10:30:00+00:00\",\n \"issueBoardPosition\": 42,\n \"issueStatusPosition\": 42\n}"
response = http.request(request)
puts response.read_body{
"id": 42,
"title": "Volunteer Coordinator",
"content": "<p>Hello {{firstName}},</p><p>You're invited.</p>",
"mainPost": {
"id": 42,
"owner": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"fullName": "James Patterson",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png"
},
"childrenCount": 12,
"dateCreated": "2026-01-15T10:30:00+00:00",
"mentions": [
{
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"fullName": "James Patterson",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png"
}
],
"content": "<p>Hello {{firstName}},</p><p>You're invited.</p>",
"reactionData": [
"string"
],
"myReactions": [
"string"
],
"embedOpenGraph": {
"id": 42,
"url": "https://civic-collective.example.com/agm",
"openGraph": [
"string"
]
},
"medias": [
{
"id": 42,
"size": 42,
"entityId": 42,
"contentUrl": "https://civic-collective.example.com",
"type": "MEMBER",
"mimeType": "application/pdf",
"originalName": "Boston Chapter"
}
],
"isDeleted": false,
"moderated": "/api/v1/logs/1",
"parentId": 42
},
"postsCount": 12,
"unit": {
"id": 42,
"name": "Boston Chapter"
},
"isReadOnly": true,
"topics": [
{
"id": 42,
"name": "Boston Chapter",
"type": "/api/v1/topic_types/1"
}
],
"namespace": {
"id": 42,
"name": "Boston Chapter"
},
"assignee": {
"id": 42,
"firstName": "James",
"lastName": "Patterson",
"fullName": "James Patterson",
"logo": "https://cdn.orgo.space/tenants/acme/logo.png"
},
"priority": 42,
"position": 42,
"isArchived": false,
"isSupport": true,
"supportMetadata": "string",
"supportAnonymous": [
"string"
],
"isIssue": true,
"issueStatus": {
"id": 42,
"name": "Boston Chapter",
"color": "#16A34A"
},
"issueType": {
"id": 42,
"name": "Boston Chapter",
"color": "#16A34A"
},
"dueDate": "2026-01-15T10:30:00+00:00",
"viewsCount": 12,
"reactionsCount": 12,
"issueBoardPosition": 42,
"issueStatusPosition": 42
}Authorizations
Server-to-server authentication. Generate a token in the admin UI at
Settings → Developers → API Access. Send the raw token in the
Api-Token header — there is no Bearer prefix.
Tokens can be marked read-only at creation time, in which case the API
rejects any non-GET request with 403 Forbidden.
Body
The new Discussion resource
"/api/v1/units/1"
"/api/v1/discussion_namespaces/1"
"/api/v1/users/1"
"/api/v1/issue_statuses/1"
"/api/v1/issue_types/1"
Response
Discussion resource created
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes

