PUT api/datafiles/{id}

Updates a DataFile entity.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
id

The id of the data file to update.

globally unique identifier

Required

Body Parameters

The data file model to update with.

DataFileDto
NameDescriptionTypeAdditional information
Id

globally unique identifier

None.

Name

string

Required

String length: inclusive between 0 and 80

Path

string

String length: inclusive between 0 and 512

UserId

globally unique identifier

None.

IsInLibrary

boolean

None.

CreationDate

date

None.

SchemaId

globally unique identifier

Required

FileData

Collection of byte

None.

OriginalRecordCount

integer

None.

PostSuppressionRecordCount

integer

None.

ByteCount

integer

None.

TenantId

globally unique identifier

None.

FolderId

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.

ExpiryDate

date

None.

PublishDate

date

None.

IsPurchaseData

boolean

None.

DataSource

string

String length: inclusive between 0 and 512

MaxUseCount

integer

None.

IsSelectable

boolean

None.

DataListId

globally unique identifier

None.

DataFileExtension

string

None.

ReasonForSuppression

string

String length: inclusive between 0 and 512

DataFileProperties

Collection of DataFilePropertyDto

None.

Recipients

Collection of RecipientDto

None.

AuditLogs

Collection of DataFileAuditLogDto

None.

Request Formats

application/json, text/json

Sample:
{
  "AuditLogs": [
    {
      "Id": "1a1dc608-84d7-4862-9185-333ba45940b1",
      "DataFileId": "314163a5-9107-49ca-92d1-4e1eab1270c3",
      "CreationDateUtc": "2026-01-07T07:23:29.192554+00:00",
      "ActionType": 0,
      "ChangedByUserId": "ea9a9235-0282-4490-b093-03f90b7c5519",
      "Description": "sample string 5"
    },
    {
      "Id": "1a1dc608-84d7-4862-9185-333ba45940b1",
      "DataFileId": "314163a5-9107-49ca-92d1-4e1eab1270c3",
      "CreationDateUtc": "2026-01-07T07:23:29.192554+00:00",
      "ActionType": 0,
      "ChangedByUserId": "ea9a9235-0282-4490-b093-03f90b7c5519",
      "Description": "sample string 5"
    }
  ],
  "Id": "45e2bc30-62be-43e1-8e7e-a4a2e4de3e90",
  "Name": "sample string 2",
  "Path": "sample string 3",
  "UserId": "7fc0c372-7844-4bf4-ba43-b7eff8fed3d0",
  "IsInLibrary": true,
  "CreationDate": "2026-01-07T07:23:29.192554+00:00",
  "SchemaId": "f9072038-18ee-4476-8b24-11e1c4a29a77",
  "FileData": "QEA=",
  "OriginalRecordCount": 8,
  "PostSuppressionRecordCount": 9,
  "ByteCount": 10,
  "TenantId": "9d81d8bc-3651-4c22-aacf-6c338cc13386",
  "FolderId": "af8f975e-ab00-422d-947b-3298113d6ef2",
  "ViewPermissionGroupId": "30f9b0f7-053d-4d52-be97-6a9366a9f093",
  "EditPermissionGroupId": "e97d9bda-c6df-4951-a7c8-161fd7e9c283",
  "DeletePermissionGroupId": "3be1f50d-707b-4042-8830-2febd375b9be",
  "CanEdit": true,
  "CanDelete": true,
  "ExpiryDate": "2026-01-07T07:23:29.192554+00:00",
  "PublishDate": "2026-01-07T07:23:29.192554+00:00",
  "IsPurchaseData": true,
  "DataSource": "sample string 14",
  "MaxUseCount": 15,
  "IsSelectable": true,
  "DataListId": "bb6990e7-79b1-49cf-80dc-fbbe34db56f0",
  "DataFileExtension": "sample string 17",
  "ReasonForSuppression": "sample string 18",
  "DataFileProperties": [
    {
      "Id": "0180cee9-a6dd-4136-8e2c-dd52a72f4222",
      "Name": "sample string 2",
      "Value": "sample string 3",
      "CreationDate": "2026-01-07T07:23:29.192554+00:00",
      "DataFileId": "77bcfa6a-6236-4de0-bb84-7253f2aa1361"
    },
    {
      "Id": "0180cee9-a6dd-4136-8e2c-dd52a72f4222",
      "Name": "sample string 2",
      "Value": "sample string 3",
      "CreationDate": "2026-01-07T07:23:29.192554+00:00",
      "DataFileId": "77bcfa6a-6236-4de0-bb84-7253f2aa1361"
    }
  ],
  "Recipients": [
    {
      "Id": "cf42551f-8d83-433a-a3e3-20880d4af566",
      "TenantId": "4b2a1541-c374-4e2a-828f-371cde92a760",
      "ExternalId": "sample string 3",
      "CreationDate": "2026-01-07T07:23:29.192554+00:00"
    },
    {
      "Id": "cf42551f-8d83-433a-a3e3-20880d4af566",
      "TenantId": "4b2a1541-c374-4e2a-828f-371cde92a760",
      "ExternalId": "sample string 3",
      "CreationDate": "2026-01-07T07:23:29.192554+00:00"
    }
  ]
}

application/xml, text/xml

Sample:
<DataFileDto xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Aardvark.DataManagement.Models">
  <AuditLogs>
    <DataFileAuditLogDto>
      <ActionType>Create</ActionType>
      <ChangedByUserId>ea9a9235-0282-4490-b093-03f90b7c5519</ChangedByUserId>
      <CreationDateUtc>2026-01-07T07:23:29.192554+00:00</CreationDateUtc>
      <DataFileId>314163a5-9107-49ca-92d1-4e1eab1270c3</DataFileId>
      <Description>sample string 5</Description>
      <Id>1a1dc608-84d7-4862-9185-333ba45940b1</Id>
    </DataFileAuditLogDto>
    <DataFileAuditLogDto>
      <ActionType>Create</ActionType>
      <ChangedByUserId>ea9a9235-0282-4490-b093-03f90b7c5519</ChangedByUserId>
      <CreationDateUtc>2026-01-07T07:23:29.192554+00:00</CreationDateUtc>
      <DataFileId>314163a5-9107-49ca-92d1-4e1eab1270c3</DataFileId>
      <Description>sample string 5</Description>
      <Id>1a1dc608-84d7-4862-9185-333ba45940b1</Id>
    </DataFileAuditLogDto>
  </AuditLogs>
  <ByteCount>10</ByteCount>
  <CanDelete>true</CanDelete>
  <CanEdit>true</CanEdit>
  <CreationDate>2026-01-07T07:23:29.192554+00:00</CreationDate>
  <DataFileExtension>sample string 17</DataFileExtension>
  <DataFileProperties>
    <DataFilePropertyDto>
      <CreationDate>2026-01-07T07:23:29.192554+00:00</CreationDate>
      <DataFileId>77bcfa6a-6236-4de0-bb84-7253f2aa1361</DataFileId>
      <Id>0180cee9-a6dd-4136-8e2c-dd52a72f4222</Id>
      <Name>sample string 2</Name>
      <Value>sample string 3</Value>
    </DataFilePropertyDto>
    <DataFilePropertyDto>
      <CreationDate>2026-01-07T07:23:29.192554+00:00</CreationDate>
      <DataFileId>77bcfa6a-6236-4de0-bb84-7253f2aa1361</DataFileId>
      <Id>0180cee9-a6dd-4136-8e2c-dd52a72f4222</Id>
      <Name>sample string 2</Name>
      <Value>sample string 3</Value>
    </DataFilePropertyDto>
  </DataFileProperties>
  <DataListId>bb6990e7-79b1-49cf-80dc-fbbe34db56f0</DataListId>
  <DataSource>sample string 14</DataSource>
  <DeletePermissionGroupId>3be1f50d-707b-4042-8830-2febd375b9be</DeletePermissionGroupId>
  <EditPermissionGroupId>e97d9bda-c6df-4951-a7c8-161fd7e9c283</EditPermissionGroupId>
  <ExpiryDate>2026-01-07T07:23:29.192554+00:00</ExpiryDate>
  <FileData>QEA=</FileData>
  <FolderId>af8f975e-ab00-422d-947b-3298113d6ef2</FolderId>
  <Id>45e2bc30-62be-43e1-8e7e-a4a2e4de3e90</Id>
  <IsInLibrary>true</IsInLibrary>
  <IsPurchaseData>true</IsPurchaseData>
  <IsSelectable>true</IsSelectable>
  <MaxUseCount>15</MaxUseCount>
  <Name>sample string 2</Name>
  <OriginalRecordCount>8</OriginalRecordCount>
  <Path>sample string 3</Path>
  <PostSuppressionRecordCount>9</PostSuppressionRecordCount>
  <PublishDate>2026-01-07T07:23:29.192554+00:00</PublishDate>
  <ReasonForSuppression>sample string 18</ReasonForSuppression>
  <Recipients>
    <RecipientDto>
      <CreationDate>2026-01-07T07:23:29.192554+00:00</CreationDate>
      <ExternalId>sample string 3</ExternalId>
      <Id>cf42551f-8d83-433a-a3e3-20880d4af566</Id>
      <TenantId>4b2a1541-c374-4e2a-828f-371cde92a760</TenantId>
    </RecipientDto>
    <RecipientDto>
      <CreationDate>2026-01-07T07:23:29.192554+00:00</CreationDate>
      <ExternalId>sample string 3</ExternalId>
      <Id>cf42551f-8d83-433a-a3e3-20880d4af566</Id>
      <TenantId>4b2a1541-c374-4e2a-828f-371cde92a760</TenantId>
    </RecipientDto>
  </Recipients>
  <SchemaId>f9072038-18ee-4476-8b24-11e1c4a29a77</SchemaId>
  <TenantId>9d81d8bc-3651-4c22-aacf-6c338cc13386</TenantId>
  <UserId>7fc0c372-7844-4bf4-ba43-b7eff8fed3d0</UserId>
  <ViewPermissionGroupId>30f9b0f7-053d-4d52-be97-6a9366a9f093</ViewPermissionGroupId>
</DataFileDto>

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

None.