PUT api/datalists/{id}

Updates a DataList entity.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
id

The id of the data list to update.

globally unique identifier

Required

Body Parameters

The data list model to update with.

DataListDto
NameDescriptionTypeAdditional information
Id

globally unique identifier

None.

Name

string

Required

String length: inclusive between 0 and 80

CreationDate

date

Required

CreatorUserId

globally unique identifier

None.

DataRetentionPeriod

integer

None.

AvailableStatusesIds

Collection of globally unique identifier

None.

FlushOnUse

boolean

None.

FolderId

globally unique identifier

None.

SchemaId

globally unique identifier

None.

ViewPermissionGroupId

globally unique identifier

None.

EditPermissionGroupId

globally unique identifier

None.

DeletePermissionGroupId

globally unique identifier

None.

CanEdit

boolean

None.

CanDelete

boolean

None.

Recipients

Collection of RecipientDto

None.

Request Formats

application/json, text/json

Sample:
{
  "Id": "1988178d-38e7-44dd-b2a0-fbb5030725ed",
  "Name": "sample string 2",
  "CreationDate": "2026-01-08T10:12:15.5223428+00:00",
  "CreatorUserId": "c26aed32-6d8d-417e-97bc-7963d9210fe3",
  "DataRetentionPeriod": 5,
  "AvailableStatusesIds": [
    "e3c4c231-c533-45a1-8926-99ee9adef59e",
    "fa1e942a-28ea-4f13-a4bc-cbfde62166be"
  ],
  "FlushOnUse": true,
  "FolderId": "e6a31da4-31aa-498f-9da7-e2118e3eac45",
  "SchemaId": "9a9d75e3-4881-4f07-a9dc-036dcd8a4930",
  "ViewPermissionGroupId": "b6b9908a-ef24-4edf-bb6a-917d54f35ee5",
  "EditPermissionGroupId": "8b75e33d-1470-4bb7-9d01-990e46e15f41",
  "DeletePermissionGroupId": "e3312539-efae-4ce9-be37-47915ee162e3",
  "CanEdit": true,
  "CanDelete": true,
  "Recipients": [
    {
      "Id": "a7c6db5b-71aa-4308-b18b-bbf9c9624594",
      "TenantId": "49415e03-eeae-49cd-9317-248aedbca866",
      "ExternalId": "sample string 3",
      "CreationDate": "2026-01-08T10:12:15.5223428+00:00"
    },
    {
      "Id": "a7c6db5b-71aa-4308-b18b-bbf9c9624594",
      "TenantId": "49415e03-eeae-49cd-9317-248aedbca866",
      "ExternalId": "sample string 3",
      "CreationDate": "2026-01-08T10:12:15.5223428+00:00"
    }
  ]
}

application/xml, text/xml

Sample:
<DataListDto xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Aardvark.DataManagement.Models">
  <AvailableStatusesIds xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:guid>e3c4c231-c533-45a1-8926-99ee9adef59e</d2p1:guid>
    <d2p1:guid>fa1e942a-28ea-4f13-a4bc-cbfde62166be</d2p1:guid>
  </AvailableStatusesIds>
  <CanDelete>true</CanDelete>
  <CanEdit>true</CanEdit>
  <CreationDate>2026-01-08T10:12:15.5223428+00:00</CreationDate>
  <CreatorUserId>c26aed32-6d8d-417e-97bc-7963d9210fe3</CreatorUserId>
  <DataRetentionPeriod>5</DataRetentionPeriod>
  <DeletePermissionGroupId>e3312539-efae-4ce9-be37-47915ee162e3</DeletePermissionGroupId>
  <EditPermissionGroupId>8b75e33d-1470-4bb7-9d01-990e46e15f41</EditPermissionGroupId>
  <FlushOnUse>true</FlushOnUse>
  <FolderId>e6a31da4-31aa-498f-9da7-e2118e3eac45</FolderId>
  <Id>1988178d-38e7-44dd-b2a0-fbb5030725ed</Id>
  <Name>sample string 2</Name>
  <Recipients>
    <RecipientDto>
      <CreationDate>2026-01-08T10:12:15.5223428+00:00</CreationDate>
      <ExternalId>sample string 3</ExternalId>
      <Id>a7c6db5b-71aa-4308-b18b-bbf9c9624594</Id>
      <TenantId>49415e03-eeae-49cd-9317-248aedbca866</TenantId>
    </RecipientDto>
    <RecipientDto>
      <CreationDate>2026-01-08T10:12:15.5223428+00:00</CreationDate>
      <ExternalId>sample string 3</ExternalId>
      <Id>a7c6db5b-71aa-4308-b18b-bbf9c9624594</Id>
      <TenantId>49415e03-eeae-49cd-9317-248aedbca866</TenantId>
    </RecipientDto>
  </Recipients>
  <SchemaId>9a9d75e3-4881-4f07-a9dc-036dcd8a4930</SchemaId>
  <ViewPermissionGroupId>b6b9908a-ef24-4edf-bb6a-917d54f35ee5</ViewPermissionGroupId>
</DataListDto>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

None.