GET organization/…/license

Retrieves the license details for content published by an organization.

Resource URL

https://www.drillster.com/api/2.1.1/organization/{organization_id}/license

or

https://www.drillster.com/api/2.1.1/organization/self/license

Parameters

Field Type Description
organization_id
optional		 String The organization ID to retrieve the license details for. May be replaced with self to refer to the own organization.

Example value: nPjYUn0upc8dIm7yzTIBgQ

Response

A 2.1.1 License object with the details of the publication license.

Example request

GET https://www.drillster.com/api/2.1.1/organization/nPjYUn0upc8dIm7yzTIBgQ/license

Response

{
  "type": "CLOSED",
  "text": "Copyright © Acme Inc",
  "icon": {
    "url": "https://www.example.com/copyright-license.png"
  }
}

Error responses

The following error situations are possible:

ID Response code Description
not_permitted 403 (Forbidden) User is not permitted to retrieve publication license details.
not_linked_to_organization 400 (Bad request) No specific organization was requested, and the requesting user is not linked to an organization.
not_found 404 (Not found) Requested organization does not exist.

 

Last updated on