Updates the extraction code on caseId found by extractionCodeId or code, with the same fields as the member route (label, due date, configuration or custodian), and returns the code. Configuration cannot change once the code is locked. Returns 404 when the case has no such code. Super admin only.
Body
Required
-
Minimum length is
3, maximum length is100. -
Minimum length is
3, maximum length is100. -
Minimum length is
3, maximum length is50. -
Minimum length is
3, maximum length is100. -
Default value is
false. -
OC cases only: when false, the OL creates/keeps this code without the opposing-council approval gate (code stays
na, immediately usable, and the custodian email is sent). Ignored on non-OC cases. Defaults to true (gate on).Default value is
true. -
Whether payment is required for this extraction code
-
Payment amount in cents
-
Payment currency (defaults to usd)
Default value is
usd. -
Payment success redirect URL
-
Product name
-
Prepaid basket. Each entry becomes its own Stripe line item and grants units on payment. Prices are negotiable — unitAmountCents is what the customer is charged, and is never validated against the catalog default.
-
required if code is not provided
-
required if extractionCodeId is not provided
curl \
--request POST 'http://api.example.com/admin/case/update-extraction-codes' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"custodianEmail": "string",
"custodianName": "string",
"custodianPhone": "string",
"sendEmail": true,
"label": "string",
"allowShareAll": true,
"config": {
"type": "allow_client",
"ignoreMediaPermissionAndroid": false,
"origin": "string",
"enableFileUpload": false,
"enableLocalExport": {
"formats": [],
"defaultConfig": {
"chunkType": "none",
"includeAttachments": true
}
},
"allowClient": {
"allowSocialApps": [],
"allowShareAll": false
},
"autoShare": {
"allowClientApproval": true,
"allowAdditionalShare": true,
"searches": [
{
"type": "name",
"values": [
"string"
],
"apps": [],
"dateRange": {
"start": "string",
"end": "string"
},
"exactMatch": false,
"include": true,
"conversationType": "all"
}
]
},
"shareAll": {
"apps": [
"string"
],
"includeAttachments": true,
"dateRange": {
"start": "string",
"end": "string"
},
"searchesExclude": [
{
"type": "name",
"values": [
"string"
],
"apps": [
"string"
],
"exactMatch": true,
"conversationType": "all"
}
]
},
"dateRange": {
"start": "string",
"end": "string"
},
"appConfig": {
"conversionConcurrency": {
"mediaType": "images",
"concurrency": [
42.0
]
},
"compressionConcurrency": {
"mediaType": "images",
"concurrency": [
42.0
]
},
"enableLocalMediaConversion": false,
"enableLocalMediaCompression": false,
"enableIosEncryptedBackupExtraction": false,
"allowOnlyEncryptedIosBackup": false,
"autoIncludeSafariData": false,
"autoIncludeNotesData": false,
"autoIncludeContacts": false,
"shareAction": "share"
}
},
"requestedSources": [
"string"
],
"dueDate": "string",
"sendReminders": {
"dueIn2Weeks": false,
"dueIn1Week": false,
"dueIn3Days": false,
"dueIn1Day": false,
"after1Week": false,
"after2Weeks": false,
"after1Month": false
},
"metadata": {},
"watchlist": false,
"ocRequired": true,
"paymentRequired": true,
"paymentAmount": 42.0,
"paymentCurrency": "usd",
"paymentSuccessRedirectUrl": "string",
"productName": "string",
"prepaidItems": [
{
"productKey": "prepaid.device",
"quantity": 1,
"unitAmountCents": 42.0
}
],
"caseId": "string",
"extractionCodeId": "string",
"code": "string"
}'
{
"custodianEmail": "string",
"custodianName": "string",
"custodianPhone": "string",
"sendEmail": true,
"label": "string",
"allowShareAll": true,
"config": {
"type": "allow_client",
"ignoreMediaPermissionAndroid": false,
"origin": "string",
"enableFileUpload": false,
"enableLocalExport": {
"formats": [],
"defaultConfig": {
"chunkType": "none",
"includeAttachments": true
}
},
"allowClient": {
"allowSocialApps": [],
"allowShareAll": false
},
"autoShare": {
"allowClientApproval": true,
"allowAdditionalShare": true,
"searches": [
{
"type": "name",
"values": [
"string"
],
"apps": [],
"dateRange": {
"start": "string",
"end": "string"
},
"exactMatch": false,
"include": true,
"conversationType": "all"
}
]
},
"shareAll": {
"apps": [
"string"
],
"includeAttachments": true,
"dateRange": {
"start": "string",
"end": "string"
},
"searchesExclude": [
{
"type": "name",
"values": [
"string"
],
"apps": [
"string"
],
"exactMatch": true,
"conversationType": "all"
}
]
},
"dateRange": {
"start": "string",
"end": "string"
},
"appConfig": {
"conversionConcurrency": {
"mediaType": "images",
"concurrency": [
42.0
]
},
"compressionConcurrency": {
"mediaType": "images",
"concurrency": [
42.0
]
},
"enableLocalMediaConversion": false,
"enableLocalMediaCompression": false,
"enableIosEncryptedBackupExtraction": false,
"allowOnlyEncryptedIosBackup": false,
"autoIncludeSafariData": false,
"autoIncludeNotesData": false,
"autoIncludeContacts": false,
"shareAction": "share"
}
},
"requestedSources": [
"string"
],
"dueDate": "string",
"sendReminders": {
"dueIn2Weeks": false,
"dueIn1Week": false,
"dueIn3Days": false,
"dueIn1Day": false,
"after1Week": false,
"after2Weeks": false,
"after1Month": false
},
"metadata": {},
"watchlist": false,
"ocRequired": true,
"paymentRequired": true,
"paymentAmount": 42.0,
"paymentCurrency": "usd",
"paymentSuccessRedirectUrl": "string",
"productName": "string",
"prepaidItems": [
{
"productKey": "prepaid.device",
"quantity": 1,
"unitAmountCents": 42.0
}
],
"caseId": "string",
"extractionCodeId": "string",
"code": "string"
}
{
"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": 201,
"timestamp": "2026-01-15T10:15:00.000Z"
}