curl --request PATCH \
--url https://api.tryfuse.ai/api/v1/business/lists/{listId} \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"folderId": "<string>",
"folderName": "<string>"
}
'import requests
url = "https://api.tryfuse.ai/api/v1/business/lists/{listId}"
payload = {
"name": "<string>",
"folderId": "<string>",
"folderName": "<string>"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: '<string>', folderId: '<string>', folderName: '<string>'})
};
fetch('https://api.tryfuse.ai/api/v1/business/lists/{listId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"list": {
"id": "68a1f20b9c41d20014b3e901",
"name": "Q3 fintech CFOs (US)",
"folderId": "68a1f9aa9c41d20014b3f101"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}Rename a list or move it between folders
Renames the list and/or moves it between folders. name must stay unique in the workspace (409 LIST_NAME_TAKEN). folderId moves the list into an existing folder of its own kind — an unknown id, a folder of another workspace, or one holding the other kind of list all answer 404 FOLDER_NOT_FOUND; folderId: null returns it to the root; folderName is create-or-reuse by exact, case-insensitive name for the list’s kind (mutually exclusive with folderId). A move is only reported when it actually happened: a list that is not the token owner’s to move answers 404 LIST_NOT_FOUND, and moving a list into the folder it is already in is a no-op that still answers 200. The response echoes only the fields that changed.
Errors:
404LIST_NOT_FOUND— No list with that id is visible to the token owner, or the list is not theirs to move.404FOLDER_NOT_FOUND— folderId does not name a folder of the token owner that holds lists of this list’s kind.409LIST_NAME_TAKEN— Another list already has the requested name.422VALIDATION_FAILED— No field to change, both folderId and folderName sent, or a value out of bounds.429RATE_LIMITED— The lists rate bucket is exhausted.
Requires one of the following token scopes: lists.
curl --request PATCH \
--url https://api.tryfuse.ai/api/v1/business/lists/{listId} \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"folderId": "<string>",
"folderName": "<string>"
}
'import requests
url = "https://api.tryfuse.ai/api/v1/business/lists/{listId}"
payload = {
"name": "<string>",
"folderId": "<string>",
"folderName": "<string>"
}
headers = {
"Authorization": "Basic <encoded-value>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {Authorization: 'Basic <encoded-value>', 'Content-Type': 'application/json'},
body: JSON.stringify({name: '<string>', folderId: '<string>', folderName: '<string>'})
};
fetch('https://api.tryfuse.ai/api/v1/business/lists/{listId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"list": {
"id": "68a1f20b9c41d20014b3e901",
"name": "Q3 fintech CFOs (US)",
"folderId": "68a1f9aa9c41d20014b3f101"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"param": "<string>",
"doc_url": "<string>",
"request_id": "<string>"
}
}Authorizations
Your API token (af_…) as the Basic-auth username, with an empty password.
Path Parameters
24-character hex id of the list (from GET /business/lists).
Body
New list name (1-255 characters, trimmed); must be unique in the workspace or the call answers 409 LIST_NAME_TAKEN.
1 - 255Move the list into this folder (24-character hex id of a folder of the list's own kind); null removes it from its current folder, and an unknown id answers 404 FOLDER_NOT_FOUND.
Move the list into the folder with this exact name (case-insensitive, 1-120 characters), creating it for the list's kind when none exists; mutually exclusive with folderId.
1 - 120Response
Success
Show child attributes
Show child attributes