Updates the custodian's name, email or phone on an extraction code and, when the email changes and the code is usable, re-sends the code email.
Body
Required
-
Minimum length is
3, maximum length is100. -
Minimum length is
3, maximum length is100. -
Minimum length is
3, maximum length is50. -
Whether to re-send the extraction-code email after updating contact (default true). Even when true, the email only goes out if the code is usable (na/approved) and has a custodian email.
Default value is
true.
PATCH
/case/{caseId}/extraction/{extractionCode}/custodian
curl \
--request PATCH 'http://api.example.com/case/{caseId}/extraction/{extractionCode}/custodian' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--header "organization: string" \
--data '{
"custodianEmail": "string",
"custodianName": "string",
"custodianPhone": "string",
"sendEmail": true
}'
Request examples
# Headers
organization: string
# Payload
{
"custodianEmail": "string",
"custodianName": "string",
"custodianPhone": "string",
"sendEmail": true
}
Response examples (200)
{
"data": {
"createdAt": "2026-01-15T14:30:00.000Z",
"updatedAt": "2026-01-15T14:30:00.000Z",
"id": "507f1f77bcf86cd799439011",
"code": "K7Q2-9XPL",
"email": "jane.doe@example.com",
"name": "Jane Doe",
"phone": "+15555550100",
"isActive": true,
"label": "Primary phone",
"config": {
"type": "allow_client",
"origin": "Website",
"ignoreMediaPermissionAndroid": false,
"dateRange": {
"start": "2026-05-04T09:42:00Z",
"end": "2026-05-04T09:42:00Z"
},
"appConfig": {
"conversionConcurrency": [
{
"mediaType": "images",
"concurrency": [
4,
6,
12,
16
]
}
],
"compressionConcurrency": [
{
"mediaType": "images",
"concurrency": [
4,
6,
12,
16
]
}
],
"enableLocalMediaConversion": true,
"enableLocalMediaCompression": true,
"enableIosEncryptedBackupExtraction": false,
"allowOnlyEncryptedIosBackup": false,
"autoIncludeSafariData": false,
"autoIncludeNotesData": false,
"autoIncludeContacts": false,
"shareAction": "share"
},
"enableLocalExport": {
"formats": [
"pdf"
],
"defaultConfig": {
"chunkType": "year",
"includeAttachments": true
}
},
"allowClient": {
"allowSocialApps": [
"whatsapp"
],
"allowShareAll": false
},
"autoShare": {
"allowClientApproval": false,
"allowAdditionalShare": false,
"searches": [
{
"type": "name",
"values": [
"Jane Doe"
],
"apps": [
"whatsapp"
],
"dateRange": {
"start": "2026-05-04T09:42:00Z",
"end": "2026-05-04T09:42:00Z"
},
"exactMatch": false,
"include": true,
"conversationType": "all"
}
]
},
"shareAll": {
"apps": [
"whatsapp"
],
"includeAttachments": true,
"dateRange": {
"start": "2026-05-04T09:42:00Z",
"end": "2026-05-04T09:42:00Z"
},
"searchesExclude": [
{
"type": "name",
"values": [
"Jane Doe"
],
"apps": [
"whatsapp"
],
"exactMatch": false,
"conversationType": "all"
}
]
}
},
"devices": [
{}
],
"totalDevicesCount": 1,
"dueDate": "2026-01-15T14:30:00.000Z",
"sendEmail": true,
"lockedAt": "2026-05-04T09:42:00Z",
"hasDueDateCrossed": false,
"status": "pending",
"reviewStatus": "approved",
"reviewMessage": "string",
"lastApprovedBy": {
"createdAt": "2026-01-15T14:30:00.000Z",
"updatedAt": "2026-01-15T14:30:00.000Z",
"id": "507f1f77bcf86cd799439011",
"name": "Jane Doe",
"email": "jane.doe@example.com",
"phone": [
"+15555550100"
],
"isActive": true,
"isEmailVerified": true,
"lastActive": "2026-01-15T14:30:00.000Z",
"roles": [
"user"
],
"avatar": {
"createdAt": "2026-01-15T14:30:00.000Z",
"updatedAt": "2026-01-15T14:30:00.000Z",
"id": "507f1f77bcf86cd799439011",
"name": "photo.heic",
"providerId": "uploads/507f1f77bcf86cd799439011/photo.heic",
"convertedName": "photo.jpg",
"convertedProviderId": "uploads/507f1f77bcf86cd799439011/photo.jpg",
"provider": "s3",
"size": 204800,
"transferState": 42.0
},
"onboardingStatus": "completed",
"userType": "attorney",
"firstName": "Jane",
"lastName": "Doe",
"initials": "JD",
"userOrganizations": [
{}
]
},
"ocReviewedByOrg": {
"createdAt": "2026-01-15T14:30:00.000Z",
"updatedAt": "2026-01-15T14:30:00.000Z",
"id": "507f1f77bcf86cd799439011",
"name": "Example Law LLP",
"slug": "example-law-llp",
"email": "office@example.com",
"contact": "Jane Doe",
"city": "New York",
"state": "NY",
"country": "US",
"description": "Litigation practice",
"phone": [
"+15555550100"
],
"logo": "https://files.example.com/logo.png",
"isActive": true,
"isPriority": false,
"activePlan": {
"createdAt": "2026-01-15T14:30:00.000Z",
"updatedAt": "2026-01-15T14:30:00.000Z",
"id": "507f1f77bcf86cd799439011",
"subscription": {},
"relatedSubscription": [
{}
],
"organization": {},
"seats": 5,
"seatsUsed": 3,
"devices": 10,
"deviceUsed": 4,
"storage": 100000000000,
"storageUsed": 12000000000,
"payments": [
{}
],
"type": "admin",
"isActive": true,
"isBetweenPlanChanges": false,
"storageInKb": 100000000,
"storageUsedInKb": 12000000,
"storageInMb": 100000,
"storageUsedInMb": 12000,
"storageInGb": 100,
"storageUsedInGb": 12,
"storageInTb": 0.1,
"storageUsedInTb": 0.012,
"isFreePlan": false,
"remainingSeats": 2,
"remainingDevices": 6,
"remainingStorage": 88000000000
},
"metadata": {},
"type": "law_firm",
"version": "v1"
},
"ocReviewedAt": "2026-05-04T09:42:00Z",
"ocRequired": true,
"allowShareAll": false,
"metadata": {},
"logsConfig": {},
"sources": [
{
"createdAt": "2026-01-15T14:30:00.000Z",
"updatedAt": "2026-01-15T14:30:00.000Z",
"id": "507f1f77bcf86cd799439011",
"case": {},
"extractionCode": {},
"dataSource": {
"createdAt": "2026-01-15T14:30:00.000Z",
"updatedAt": "2026-01-15T14:30:00.000Z",
"id": "507f1f77bcf86cd799439011",
"name": "gmail",
"displayName": "Gmail",
"category": "email",
"config": {
"iosEnableEncryptedBackup": true,
"iosAllowOnlyEncryptedBackup": false,
"iosAllApps": [
"messages",
"call_log",
"whatsapp",
"photos"
],
"iosAllowedApps": [
"messages",
"call_log"
]
}
},
"caseDataSource": {
"createdAt": "2026-01-15T14:30:00.000Z",
"updatedAt": "2026-01-15T14:30:00.000Z",
"id": "507f1f77bcf86cd799439011",
"case": {},
"dataSource": {
"createdAt": "2026-01-15T14:30:00.000Z",
"updatedAt": "2026-01-15T14:30:00.000Z",
"id": "507f1f77bcf86cd799439011",
"name": "gmail",
"displayName": "Gmail",
"category": "email",
"config": {
"iosEnableEncryptedBackup": true,
"iosAllowOnlyEncryptedBackup": false,
"iosAllApps": [
"messages",
"call_log",
"whatsapp",
"photos"
],
"iosAllowedApps": [
"messages",
"call_log"
]
}
},
"config": {
"iosEnableEncryptedBackup": true,
"iosAllowOnlyEncryptedBackup": false,
"iosAutoIncludeSafariData": true,
"iosAutoIncludeNotesData": false,
"iosAllowedApps": [
"messages",
"call_log",
"whatsapp"
]
}
},
"config": {
"iosEnableEncryptedBackup": true,
"iosAllowOnlyEncryptedBackup": false,
"iosAllApps": [
"messages",
"call_log",
"whatsapp",
"photos"
],
"iosAllowedApps": [
"messages",
"call_log"
]
}
}
],
"payment": {}
},
"statusCode": 200,
"timestamp": "2026-01-15T10:15:00.000Z"
}