PUT api/datalists/{id}

Updates a DataList entity.

Request Information

URI Parameters

Name	Description	Type	Additional information
id	The id of the data list to update.	globally unique identifier	Required

Body Parameters

The data list model to update with.

DataListDto

Name	Type	Additional 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": "9e2c8b08-c889-4f5e-ab68-448e97456db4",
  "Name": "sample string 2",
  "CreationDate": "2026-01-10T12:29:38.6732509+00:00",
  "CreatorUserId": "649b9b9f-1936-4953-bc5d-65a1ca659d6d",
  "DataRetentionPeriod": 5,
  "AvailableStatusesIds": [
    "992a7913-063d-4f62-8d22-bfebfe55ebad",
    "dff2451c-d8d3-4b72-acd1-86b18f20b60c"
  ],
  "FlushOnUse": true,
  "FolderId": "15cf2677-c72b-4c79-83ab-189531c8369f",
  "SchemaId": "e098fa50-3e05-4621-90eb-2a6498aa1b3e",
  "ViewPermissionGroupId": "b47fa856-9bee-4a4b-ae49-c29d7e1ec696",
  "EditPermissionGroupId": "2ea753fe-3cef-4287-9797-9ddea34d5487",
  "DeletePermissionGroupId": "d0a3920c-8d5d-4362-b47c-152994f5b049",
  "CanEdit": true,
  "CanDelete": true,
  "Recipients": [
    {
      "Id": "3b72a1f8-694c-4ae0-aee3-49ba6b344231",
      "TenantId": "315cc297-7ba9-4e20-b385-5fb3d035ffd0",
      "ExternalId": "sample string 3",
      "CreationDate": "2026-01-10T12:29:38.6732509+00:00"
    },
    {
      "Id": "3b72a1f8-694c-4ae0-aee3-49ba6b344231",
      "TenantId": "315cc297-7ba9-4e20-b385-5fb3d035ffd0",
      "ExternalId": "sample string 3",
      "CreationDate": "2026-01-10T12:29:38.6732509+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>992a7913-063d-4f62-8d22-bfebfe55ebad</d2p1:guid>
    <d2p1:guid>dff2451c-d8d3-4b72-acd1-86b18f20b60c</d2p1:guid>
  </AvailableStatusesIds>
  <CanDelete>true</CanDelete>
  <CanEdit>true</CanEdit>
  <CreationDate>2026-01-10T12:29:38.6732509+00:00</CreationDate>
  <CreatorUserId>649b9b9f-1936-4953-bc5d-65a1ca659d6d</CreatorUserId>
  <DataRetentionPeriod>5</DataRetentionPeriod>
  <DeletePermissionGroupId>d0a3920c-8d5d-4362-b47c-152994f5b049</DeletePermissionGroupId>
  <EditPermissionGroupId>2ea753fe-3cef-4287-9797-9ddea34d5487</EditPermissionGroupId>
  <FlushOnUse>true</FlushOnUse>
  <FolderId>15cf2677-c72b-4c79-83ab-189531c8369f</FolderId>
  <Id>9e2c8b08-c889-4f5e-ab68-448e97456db4</Id>
  <Name>sample string 2</Name>
  <Recipients>
    <RecipientDto>
      <CreationDate>2026-01-10T12:29:38.6732509+00:00</CreationDate>
      <ExternalId>sample string 3</ExternalId>
      <Id>3b72a1f8-694c-4ae0-aee3-49ba6b344231</Id>
      <TenantId>315cc297-7ba9-4e20-b385-5fb3d035ffd0</TenantId>
    </RecipientDto>
    <RecipientDto>
      <CreationDate>2026-01-10T12:29:38.6732509+00:00</CreationDate>
      <ExternalId>sample string 3</ExternalId>
      <Id>3b72a1f8-694c-4ae0-aee3-49ba6b344231</Id>
      <TenantId>315cc297-7ba9-4e20-b385-5fb3d035ffd0</TenantId>
    </RecipientDto>
  </Recipients>
  <SchemaId>e098fa50-3e05-4621-90eb-2a6498aa1b3e</SchemaId>
  <ViewPermissionGroupId>b47fa856-9bee-4a4b-ae49-c29d7e1ec696</ViewPermissionGroupId>
</DataListDto>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

None.