Skip to main content

Web Service Method: Create New Concept

Abstract

Web Service Method: Create New Concept

Description

Creates a new SKOS concept in your thesaurus.

URL: /PoolParty/api/thesaurus/{project}/createConcept

Note

When you think about only suggesting a new concept as well as using a review process, you could use Web Service Method: Suggest Concept

For convenience, you can use this method to create top concepts and concepts as well. When you want to create a top concept, you simply use the concept scheme URI as parent.

                              Request
                           

Supported Methods

POST

Content-Type

application/x-www-form-urlencoded

Path Variables

Variable

Comment

{project}

The UUID or the URI supplement (textual identifier) of the project to be used.

HTTP Parameters

Parameter

Comment

Type

Required

parent

URI of the concept / concept scheme that should be parent.

String

true

prefLabel

Preferred label in the default language for the newly created concept.

String

true

Response

http status code 200if OK.

String containing URL of the newly created concept.

URL Pattern

POST Request

http://<server-url>/PoolParty/api/thesaurus/<project-Id>/createConcept?parent=<parent-url>&prefLabel=<label>

Response

http://<server-url>/<project-id>/<created-concept-id>
Example

Screenshot of an example call, done with Advanced REST client:

Screen shot of an example call, done with Advanced REST client

Example Response

http://test-pp-linux.semantic-web.at/FHcorpustest/1