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