Contribly API

by contribly.com

OAuthHTTPSSocial

Overview

Discover Contribly's platform to organise, verify, and publish community-generated content, enhancing engagement and trust in your newsroom.

Contribly is a social API from contribly.com. Requests are authenticated with OAuth. It is served over HTTPS. Its OpenAPI description documents 44 endpoints.

At a glance

Authentication: OAuth
HTTPS: Yes
CORS: Unknown
Category: Social
Base URL: https://api.contribly.com/1
Version: 1.0.0
Endpoints: 44
OpenAPI: Specification ↗
Spec updated: 2023-03-06

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL

curl -X GET "https://api.contribly.com/1/artifact-formats" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"

JavaScript

const response = await fetch("https://api.contribly.com/1/artifact-formats", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
  },
});
const data = await response.json();
console.log(data);

Python

import requests

response = requests.request(
    "GET",
    "https://api.contribly.com/1/artifact-formats",
    headers={
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
    },
    timeout=30,
)
print(response.json())

Endpoints

Method	Path	What it does
GET	`/artifact-formats`	Artifact formats
GET	`/assignments`	List assignments
POST	`/assignments`	Create a new assignment
GET	`/assignments/{id}`	Get a single assigment by id
DELETE	`/assignments/{id}`	Delete this assignment and all of it's contributions
GET	`/change-log`	Recent changes
GET	`/contribution-refinement-types`	List valid contribution refinement types
GET	`/contribution-refinements`	List contribution refinement options
GET	`/contributions`	List contributions
POST	`/contributions`	Create a new contribution
GET	`/contributions/{id}`	Get a single contribution by id
DELETE	`/contributions/{id}`	Delete this contribution
POST	`/contributions/{id}/flag`	Raise a flag against this contribution
POST	`/contributions/{id}/like`	Allows a user to mark a contribution as liked
GET	`/contributions/{id}/likes`	List users who have liked this contributions
POST	`/contributions/{id}/moderate`	Perform a moderation action on this contribution
GET	`/credentials`	List the credentials associated with the authenticated user.
GET	`/event-types`	Event types
POST	`/export`	Export contributions.
POST	`/export-summary`	Export contributions preflight summary.
GET	`/exports/{id}`	Get a single export job; poll to follow export progress.
GET	`/form-responses`	List form responses
POST	`/form-responses`	Submit a response to a form
GET	`/form-responses/{id}`	Get a single form response by id
GET	`/forms`	List forms
POST	`/forms`	Create a form
GET	`/forms/{id}`	Get a single form by id
DELETE	`/forms/{id}`	Delete this form and all of it's responses.
POST	`/media`	Submit a new media file
GET	`/notifications/contributions/{id}/preview`	—
GET	`/scopes`	Scopes
GET	`/subscription-types`	Subscription types
GET	`/subscriptions`	List subscriptions for the authorised user.
DELETE	`/subscriptions/{id}`	Delete a subscription.
GET	`/tags`	List tags
POST	`/tags`	Create a new tag
GET	`/tags/{id}`	Retrieve a single tag by id
GET	`/tagsets`	List tag sets
POST	`/tagsets`	Create a new tag set
GET	`/tagsets/{id}`	Retrieve a single tag set by id
GET	`/users`	List users
GET	`/users/{id}`	Retrieve a single user by id
GET	`/users/{id}/linked/{type}`	Retrieve a users linked profile by type
POST	`/verify`	Verify token and return details of the owning user