{ "openapi": "3.0.1", "info": { "description": "This OAS file describes the NGSI-LD API defined by the ETSI ISG CIM group. This Cross-domain Context Information Management API allows to provide, consume and subscribe to context information in multiple scenarios and involving multiple stakeholders", "version": "latest", "title": "ETSI ISG CIM / NGSI-LD API", "contact": { "email": "NGSI-LD@etsi.org" } }, "externalDocs": { "description": "Find out more about the ETSI ISG Context Information Management", "url": "https://portal.etsi.org/tb.aspx?tbid=854&SubTB=854" }, "tags": [ { "name": "ETSI", "description": "European Telecommunications Standards Institute", "externalDocs": { "description": "Find out more", "url": "http://www.etsi.org" } }, { "name": "CIM", "description": "Context Information Management", "externalDocs": { "description": "Find out more", "url": "https://portal.etsi.org/tb.aspx?tbid=854&SubTB=854" } }, { "name": "JSON-LD", "description": "JSON for Linking Data", "externalDocs": { "description": "Find out more", "url": "https://json-ld.org/" } }, { "name": "NGSI-LD API", "description": "API defined by the ETSI ISG CIM", "externalDocs": { "description": "Find out more", "url": "http://www.etsi.org/deliver/etsi_gs/CIM/001_099/004/01.01.01_60/gs_CIM004v010101p.pdf" } } ], "paths": { "/entities/": { "get": { "description": "Retrieve a set of entities which matches a specific query from an NGSI-LD system", "operationId": "queryEntities", "parameters": [ { "name": "id", "description": "Comma separated list of URIs to be retrieved", "in": "query", "required": false, "schema": { "type": "string", "format": "uri" } }, { "name": "idPattern", "description": "Regular expression that must be matched by Entity ids", "in": "query", "required": false, "schema": { "type": "string", "format": "regexp" } }, { "name": "type", "description": "Comma separated list of Entity type names to be retrieved", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "attrs", "description": "Comma separated list of attribute names (properties or relationships) to be retrieved", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "q", "description": "Query", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "georel", "description": "Geo-relationship", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "enum": [ "equals", "disjoint", "intersects", "within", "contains", "overlaps" ] }, { "type": "string", "pattern": "^near;((maxDistance==\\d+)|(minDistance==\\d+))$" } ] } }, { "name": "geometry", "description": "Geometry", "in": "query", "required": false, "schema": { "type": "string", "enumeration": [ "Point", "MultiPoint", "LineString", "MultiLineString", "Polygon", "MultiPolygon" ] } }, { "name": "coordinates", "description": "Coordinates serialized as a string", "in": "query", "required": false, "schema": { "oneOf": [ { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/GeoProperty/properties/value/definitions/position" }, { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/GeoProperty/properties/value/definitions/positionArray" }, { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/GeoProperty/properties/value/definitions/lineString" }, { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/GeoProperty/properties/value/definitions/polygon" } ] } }, { "name": "geoproperty", "description": "The name of the property that contains the geo-spatial data that will be used to resolve the geoquery", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "csf", "description": "Context Source Filter", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "limit", "description": "Pagination limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 } }, { "name": "options", "description": "Options dictionary", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "keyValues", "sysAttrs" ] } } ], "responses": { "200": { "description": "OK", "content": { "application/json;application/ld+json": { "schema": { "type": "array", "items": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/Entity" } }, "examples": { "simple": { "externalValue": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/examples/EntityList-example.json" } } } } }, "400": { "description": "Bad request", "content": { "application/json;application/ld+json": { "schema": { "type": "object", "properties": { "type": { "type": "string", "format": "uri" }, "title": { "type": "string" }, "detail": { "type": "string" } }, "required": [ "type" ] } } } } } }, "post": { "description": "Create a new Entity within an NGSI-LD system", "operationId": "createEntity", "requestBody": { "required": true, "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/Entity" } } } }, "responses": { "201": { "description": "Created. Contains the resource URI of the created Entity" }, "400": { "description": "Bad request", "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1/get/responses/400/content/application~1json%3Bapplication~1ld%2Bjson/schema" } } } }, "409": { "description": "Already exists", "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1/get/responses/400/content/application~1json%3Bapplication~1ld%2Bjson/schema" } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1/get/responses/400/content/application~1json%3Bapplication~1ld%2Bjson/schema" } } } } } } }, "/entities/{entityId}": { "get": { "description": "Retrieve an specific Entity from an NGSI-LD system. It's possible to specify the Entity attributes to be retrieved by using query parameters", "operationId": "retrieveEntityById", "parameters": [ { "name": "entityId", "description": "Entity Id", "in": "path", "required": true, "schema": { "type": "string", "format": "uri" } }, { "name": "attrs", "description": "Comma separated list of attribute names (properties or relationships) to be retrieved", "in": "query", "required": false, "schema": { "type": "string", "minLength": 1 } }, { "name": "type", "description": "Entity Type", "in": "query", "required": false, "schema": { "type": "string", "pattern": "^(\\d|[a-zA-Z]|_)+$", "minLength": 1, "description": "NGSI-LD Name" } }, { "$ref": "#/paths/~1entities~1/get/parameters/11" } ], "responses": { "200": { "description": "OK", "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/Entity" }, "examples": { "simple": { "externalValue": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/examples/Entity-example.json" } } } } }, "400": { "description": "Bad request", "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1/get/responses/400/content/application~1json%3Bapplication~1ld%2Bjson/schema" } } } }, "404": { "description": "Not Found", "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1/get/responses/400/content/application~1json%3Bapplication~1ld%2Bjson/schema" } } } } } }, "delete": { "description": "Removes an specific Entity from an NGSI-LD system", "operationId": "removeEntityById", "parameters": [ { "$ref": "#/paths/~1entities~1%7BentityId%7D/get/parameters/0" }, { "$ref": "#/paths/~1entities~1%7BentityId%7D/get/parameters/2" } ], "responses": { "204": { "description": "No Content. The entity was removed successfully" }, "400": { "description": "Bad Request", "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1/get/responses/400/content/application~1json%3Bapplication~1ld%2Bjson/schema" } } } }, "404": { "description": "Not Found", "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1/get/responses/400/content/application~1json%3Bapplication~1ld%2Bjson/schema" } } } } } } }, "/entities/{entityId}/attrs/": { "post": { "description": "Append new Entity attributes to an existing Entity within an NGSI-LD system", "operationId": "appendEntityAttrs", "parameters": [ { "name": "entityId", "description": "Entity Id", "in": "path", "required": true, "schema": { "type": "string", "format": "uri" } }, { "name": "options", "description": "Indicates that no attribute overwrite shall be performed", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "noOverwrite" ] } } ], "requestBody": { "required": true, "content": { "application/json;application/ld+json": { "schema": { "$schema": "http://json-schema.org/schema#", "id": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/Entity.json", "title": "NGSI-LD Entity", "description": "NGSI-LD Entity", "definitions": { "datasetId": { "type": "string", "format": "uri" }, "instanceId": { "type": "string", "format": "uri" }, "Property": { "type": "object", "properties": { "type": { "type": "string", "const": "Property" }, "value": { "type": [ "string", "number", "boolean", "array", "object" ] }, "observedAt": { "type": "string", "format": "date-time" }, "createdAt": { "$ref": "#/paths/~1entities~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/properties/createdAt" }, "modifiedAt": { "$ref": "#/paths/~1entities~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/properties/modifiedAt" }, "datasetId": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/datasetId" }, "instanceId": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/instanceId" } }, "required": [ "type", "value" ], "additionalProperties": { "anyOf": [ { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/Property" }, { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/Relationship" } ] } }, "Relationship": { "type": "object", "properties": { "type": { "type": "string", "const": "Relationship" }, "object": { "type": "string", "format": "uri" }, "observedAt": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/Property/properties/observedAt" }, "createdAt": { "$ref": "#/paths/~1entities~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/properties/createdAt" }, "modifiedAt": { "$ref": "#/paths/~1entities~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/properties/modifiedAt" }, "datasetId": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/datasetId" }, "instanceId": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/instanceId" } }, "required": [ "type", "object" ], "additionalProperties": { "anyOf": [ { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/Property" }, { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/Relationship" } ] } }, "GeoProperty": { "type": "object", "properties": { "type": { "type": "string", "const": "GeoProperty" }, "value": { "$schema": "http://json-schema.org/draft-04/schema#", "id": "https://forge.etsi.org/gitlab/NGSI-LD/NGSI-LD/raw/master/schema/geometry-schema.json", "title": "geometry", "description": "One geometry as defined by GeoJSON. Licensed as per original source is https://github.com/fge/sample-json-schemas/blob/master/geojson/geometry.json", "type": "object", "required": [ "type", "coordinates" ], "oneOf": [ { "title": "Point", "properties": { "type": { "enum": [ "Point" ] }, "coordinates": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/GeoProperty/properties/value/definitions/position" } } }, { "title": "MultiPoint", "properties": { "type": { "enum": [ "MultiPoint" ] }, "coordinates": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/GeoProperty/properties/value/definitions/positionArray" } } }, { "title": "LineString", "properties": { "type": { "enum": [ "LineString" ] }, "coordinates": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/GeoProperty/properties/value/definitions/lineString" } } }, { "title": "MultiLineString", "properties": { "type": { "enum": [ "MultiLineString" ] }, "coordinates": { "type": "array", "items": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/GeoProperty/properties/value/definitions/lineString" } } } }, { "title": "Polygon", "properties": { "type": { "enum": [ "Polygon" ] }, "coordinates": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/GeoProperty/properties/value/definitions/polygon" } } }, { "title": "MultiPolygon", "properties": { "type": { "enum": [ "MultiPolygon" ] }, "coordinates": { "type": "array", "items": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/GeoProperty/properties/value/definitions/polygon" } } } } ], "definitions": { "position": { "description": "A single position", "type": "array", "minItems": 2, "items": [ { "type": "number" }, { "type": "number" } ], "additionalItems": false }, "positionArray": { "description": "An array of positions", "type": "array", "items": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/GeoProperty/properties/value/definitions/position" } }, "lineString": { "description": "An array of two or more positions", "allOf": [ { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/GeoProperty/properties/value/definitions/positionArray" }, { "minItems": 2 } ] }, "linearRing": { "description": "An array of four positions where the first equals the last", "allOf": [ { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/GeoProperty/properties/value/definitions/positionArray" }, { "minItems": 4 } ] }, "polygon": { "description": "An array of linear rings", "type": "array", "items": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/GeoProperty/properties/value/definitions/linearRing" } } } }, "observedAt": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/Property/properties/observedAt" }, "createdAt": { "$ref": "#/paths/~1entities~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/properties/createdAt" }, "modifiedAt": { "$ref": "#/paths/~1entities~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/properties/modifiedAt" }, "datasetId": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/datasetId" }, "instanceId": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/instanceId" } }, "required": [ "type", "value" ], "additionalProperties": { "anyOf": [ { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/Property" }, { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/Relationship" } ] } }, "Entity": { "type": "object", "properties": { "id": { "type": "string", "format": "uri" }, "type": { "$ref": "#/paths/~1entities~1%7BentityId%7D/get/parameters/2/schema" }, "@context": { "anyOf": [ { "type": "object" }, { "type": "string", "format": "uri" }, { "type": "array", "minItems": 1, "items": { "anyOf": [ { "type": "string", "format": "uri" }, { "type": "object" } ] } } ] }, "location": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/GeoProperty" }, "observationSpace": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/GeoProperty" }, "operationSpace": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/GeoProperty" }, "createdAt": { "type": "string", "format": "date-time" }, "modifiedAt": { "type": "string", "format": "date-time" } }, "required": [ "id", "type" ], "additionalProperties": { "anyOf": [ { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/Property" }, { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/Relationship" }, { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/GeoProperty" } ] }, "propertyNames": { "type": "string", "pattern": "^((\\d|[a-zA-Z]|_)+(#\\d+)?)$|^(@context)$" } } }, "allOf": [ { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/Entity" } ] } } } }, "responses": { "204": { "description": "No Content" }, "207": { "description": "Partial Success. Only the attributes included in the response payload were successfully appended", "content": { "application/json;application/ld+json": { "schema": { "$schema": "http://json-schema.org/schema#", "id": "https://uri.etsi.org/ngsi-ld/schema/UpdateResult.json", "title": "NGSI-LD Update Result", "description": "NGSI-LD Update Result", "definitions": { "UnchangedDetails": { "attributeName": { "type": "string", "pattern": "" }, "reason": { "type": "string", "minLenght": 1 } } }, "type": "object", "properties": { "updated": { "type": "array", "items": { "type": "string", "pattern": "" } }, "unchanged": { "type": "array", "items": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/responses/207/content/application~1json%3Bapplication~1ld%2Bjson/schema/definitions/UnchangedDetails" } } } } } } }, "400": { "description": "Bad request", "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1/get/responses/400/content/application~1json%3Bapplication~1ld%2Bjson/schema" } } } }, "404": { "description": "Not Found", "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1/get/responses/400/content/application~1json%3Bapplication~1ld%2Bjson/schema" } } } } } }, "patch": { "description": "Update existing Entity attributes within an NGSI-LD system", "operationId": "updateEntityAttrs", "parameters": [ { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/parameters/0" } ], "requestBody": { "required": true, "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema" } } } }, "responses": { "204": { "description": "No Content." }, "207": { "description": "Partial Success. Only the attributes included in the response payload were successfully updated", "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/responses/207/content/application~1json%3Bapplication~1ld%2Bjson/schema" } } } }, "400": { "description": "Bad Request", "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1/get/responses/400/content/application~1json%3Bapplication~1ld%2Bjson/schema" } } } }, "404": { "description": "Not Found", "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1/get/responses/400/content/application~1json%3Bapplication~1ld%2Bjson/schema" } } } } } } }, "/entities/{entityId}/attrs/{attrId}": { "patch": { "description": "Update existing Entity attributes within an NGSI-LD system", "operationId": "partialAttrUpdate", "parameters": [ { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/parameters/0" }, { "name": "attrId", "description": "Attribute Id", "in": "path", "required": true, "schema": { "$ref": "#/paths/~1entities~1%7BentityId%7D/get/parameters/2/schema" } } ], "requestBody": { "required": true, "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/requestBody/content/application~1json%3Bapplication~1ld%2Bjson/schema" } } } }, "responses": { "204": { "description": "No Content." }, "400": { "description": "Bad Request", "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1/get/responses/400/content/application~1json%3Bapplication~1ld%2Bjson/schema" } } } }, "404": { "description": "Not Found", "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1/get/responses/400/content/application~1json%3Bapplication~1ld%2Bjson/schema" } } } } } }, "delete": { "description": "Removes an existing Entity attribute within an NGSI-LD system", "operationId": "removeEntityAttr", "parameters": [ { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1/post/parameters/0" }, { "$ref": "#/paths/~1entities~1%7BentityId%7D~1attrs~1%7BattrId%7D/patch/parameters/1" } ], "responses": { "204": { "description": "No Content." }, "400": { "description": "Bad Request", "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1/get/responses/400/content/application~1json%3Bapplication~1ld%2Bjson/schema" } } } }, "404": { "description": "Not Found", "content": { "application/json;application/ld+json": { "schema": { "$ref": "#/paths/~1entities~1/get/responses/400/content/application~1json%3Bapplication~1ld%2Bjson/schema" } } } } } } } } }