POST /reference_data_collections/set_entries/{id}

Update a Set Entry given the properties based in the body DTO. Only the notes field can be modified in an existing entry. The source and last_seen timestamp will be updated automatically.

Table 1. POST /reference_data_collections/set_entries/{id} resource details
MIME Type

application/json

Table 2. POST /reference_data_collections/set_entries/{id} request parameter details
Parameter Type Optionality Data Type MIME Type Description

id

path

Required

Number (Integer)

text/plain

- The ID for the Set Entry

fields

header

Optional

String

text/plain

Optional - Use this parameter to specify which fields you would like to get back in the response. Fields that are not named are excluded. Specify subfields in brackets and multiple fields in the same object are separated by commas.

Table 3. POST /reference_data_collections/set_entries/{id} request body details
Parameter Data Type MIME Type Description Sample

body

Object

application/json

- The Set Entry DTO specifying the new Set properties

{ "collection_id": 42, "delete_entry": true, "domain_id": 42, "first_seen": 42, "id": 42, "last_seen": 42, "notes": "String", "source": "String", "value": "String" }

Table 4. POST /reference_data_collections/set_entries/{id} response codes
HTTP Response Code Unique Code Description

403

21002

The operation was not allowed

404

21000

The id could not be located

422

21001

null

422

21003

The notes field exceeded the allowed limit

500

110000

Unexpected internal server error

Response Description

200 and the updated Set DTO

Response Sample


{
    "collection_id": 42,
    "delete_entry": true,
    "domain_id": 42,
    "first_seen": 42,
    "id": 42,
    "last_seen": 42,
    "notes": "String",
    "source": "String",
    "value": "String"
}