Conduct.io Group decisions made easy
API
Topics
List all Topics
GET http://conduct.io/api/v1/topics
Headers
| Input | Type | Description | Default | required |
|---|---|---|---|---|
X-API-Key |
string |
your account API key | null |
true |
Inputs
| Input | Type | Description | Default | Options |
|---|---|---|---|---|
per_page |
integer |
results to show per page | 20 |
[1..10000] |
sort_field |
string |
field to sort by | created_at |
id, title, created_at |
sort_dir |
string |
direction to sort by | desc |
asc, desc |
Limitations
- Topics are private, you can only list topics that you own.
Create a Topic
POST http://conduct.io/api/v1/topics`
Headers
| Input | Type | Description | Default | required |
|---|---|---|---|---|
X-API-Key |
string |
your account API key | null |
true |
Inputs
| Input | Type | Description | Default | Required |
|---|---|---|---|---|
title |
string |
topic title | null |
true |
description |
string |
topic description | null |
false |
locked |
boolean |
is the topic locked | false |
false |
Limitations
none
Edit a Topic
PUT http://conduct.io/api/v1/topics/:topic_id
Headers
| Input | Type | Description | Default | required |
|---|---|---|---|---|
X-API-Key |
string |
your account API key | null |
true |
Inputs
| Input | Type | Description | Default | Required |
|---|---|---|---|---|
title |
string |
topic title | current | false |
description |
string |
topic description | current | false |
locked |
boolean |
is the topic locked | current | false |
Limitations
- You must be the owner of the topic
Delete a Topic
DELETE http://conduct.io/api/v1/topics/:topic_id
Headers
| Input | Type | Description | Default | required |
|---|---|---|---|---|
X-API-Key |
string |
your account API key | null |
true |
Inputs
none
Limitations
- You must be the owner of the topic
Suggestions
List suggestions for a given topic
GET http://conduct.io/api/v1/topics/:topic_id/suggestions
Headers
| Input | Type | Description | Default | required |
|---|---|---|---|---|
X-API-Key |
string |
your account API key | null |
true |
Inputs
| Input | Type | Description | Default | Options |
|---|---|---|---|---|
per_page |
integer |
results to show per page | 20 |
[1..10000] |
sort_field |
string |
field to sort by | created_at |
id, title, created_at |
sort_dir |
string |
direction to sort by | desc |
asc, desc |
Limitations
- Topics are private, you can only list topics that you own.
Create a suggestion on a given topic
POST http://conduct.io/api/v1/topics`
Headers
| Input | Type | Description | Default | required |
|---|---|---|---|---|
X-API-Key |
string |
your account API key | null |
true |
Inputs
| Input | Type | Description | Default | Required |
|---|---|---|---|---|
title |
string |
suggestion title | null |
true |
description |
string |
suggestion description | empty string | false |
Limitations
none
Edit a Suggestion
PUT http://conduct.io/api/v1/suggestions/:suggestion_id
or
PUT http://conduct.io/api/v1/topics/:topic_id/suggestions/:suggestion_id
Headers
| Input | Type | Description | Default | required |
|---|---|---|---|---|
X-API-Key |
string |
your account API key | null |
true |
Inputs
| Input | Type | Description | Default | Required |
|---|---|---|---|---|
title |
string |
topic title | current | false |
description |
string |
topic description | current | false |
locked |
boolean |
is the topic locked | current | false |
Limitations
- You must be the owner of the topic
Delete a Suggestion
DELETE http://conduct.io/api/v1/suggestions/:suggestion_id
or
DELETE http://conduct.io/api/v1/topics/:topic_id/suggestions/:suggestion_id
Headers
| Input | Type | Description | Default | required |
|---|---|---|---|---|
X-API-Key |
string |
your account API key | null |
true |
Inputs
none
Limitations
- You must be the owner of the topic