Skip to main content

Web Service Method: Update Literal of a Concept or Concept Scheme

Abstract

Web Service Method: Update Literal of a Concept or Concept Scheme

Description

Updates a SKOS literal of a concept or concept scheme.

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

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

resource

URI of the Resource

String

true

newLabel

The new value for the RDF literal

String

true

oldLabel

The outdated value of the RDF literal

String

true

language

The language of the literal - default language if not defined

String

false

property

The type of skos label.

Possible values for concepts: skos:prefLabel, skos:altLabel, skos:hiddenLabel, skos:definition, skos:notation, skos:example, skos:scopeNote

Possible values for concept schemes: dct:title, dct:subject, dct:description, dct:publisher, dct:contributor, dct:creator

See full list of Retrieve Properties in API Requests.

String

true

Response

http status code: 200 if OK.

Note

The service checks if operation is SKOS compatible. For example you can not update an alternative label so that it matches a preferred label. In such cases a http status code 400 is returned, together with a message about the causes for the bad request error.

Example

POST Request

http://<server-url>/PoolParty/api/thesaurus/APItests/updateLiteral?resource=http://test.info/glossary/2614&newLabel=Test preflabel&oldLabel=carbon price&language=en&property=skos:prefLabel