0

Update a folder

by
Published Oct 17, 2025

Updates an existing folder by setting field values. Any fields not provided remain unchanged. Permissions and other requirements SubscriptionCompany User typeBusiness PermissionsEdit Attachment Folders

Script sage_intacct Verified

The script

Submitted by hugo697 Bun
Verified 235 days ago
1
//native
2
type SageIntacct = {
3
	token: string
4
}
5
/**
6
 * Update a folder
7
 * Updates an existing folder by setting field values. Any fields not provided remain unchanged.
8

9

10
Permissions and other requirements
11

12
SubscriptionCompany
13
User typeBusiness
14
PermissionsEdit Attachment Folders
15

16

17

18

19
 */
20
export async function main(
21
	auth: SageIntacct,
22
	key: string,
23
	body: {
24
		key?: string
25
		id?: string
26
		description?: string
27
		parent?: { key?: string; id?: string; href?: string }
28
		entity?: { key?: string; id?: string; name?: string; href?: string }
29
		href?: string
30
		status?: 'active' | 'inactive'
31
		audit?: {
32
			createdDateTime?: string
33
			modifiedDateTime?: string
34
			createdBy?: string
35
			modifiedBy?: string
36
		} & {
37
			createdDateTime?: string
38
			modifiedDateTime?: string
39
			modifiedBy?: string
40
		}
41
	} & { id?: {} }
42
) {
43
	const url = new URL(`https://api.intacct.com/ia/api/v1/objects/company-config/folder/${key}`)
44

45
	const response = await fetch(url, {
46
		method: 'PATCH',
47
		headers: {
48
			'Content-Type': 'application/json',
49
			Authorization: 'Bearer ' + auth.token
50
		},
51
		body: JSON.stringify(body)
52
	})
53
	if (!response.ok) {
54
		const text = await response.text()
55
		throw new Error(`${response.status} ${text}`)
56
	}
57
	return await response.json()
58
}
59