List tags in an organisation

Endpoint

GET v1/organisations/{id}/tags

Response Codes

200 OK	Successfully listed the tags
403 Not Authorised	You aren't allowed to list the tags (not in that organisation)

Response Body

An array of tags. See "Get a tag" for the fields. Note that there won't be a number_of_articles or number_of_images field, which is only available when getting a particular tag by ID.

Create a tag in an organisation

Endpoint

POST v1/organisations/{id}/tags

Request Body

field	required	type	description
name	yes	string	The tag name
description	no	string	The tag description

Example Request Body

{
    "name": "Sport",
    "description": "All the sport at the College"
}

Response Codes

201 Created	The tag was created successfully
403 Not Authorised	You aren't allowed to create the tag

Response Body

The newly created tag object. See "Get a tag" for the fields.