Folders

Delete a folder (its lists move to the root)

Deletes a folder; the lists (or campaigns/agents) it held are not deleted and move back to the root. List folders resolve by id alone; pass ?type=campaign or ?type=agent for those folder kinds.

Errors:

  • 404 FOLDER_NOT_FOUND — No folder with that id (of the routed kind) belongs to the token owner.
  • 400 INVALID_REQUEST — campaign/agent kinds only: the owning service rejected the request.
  • 422 VALIDATION_FAILED — folderId not a 24-hex id, or type outside the enum.
  • 429 RATE_LIMITED — The lists rate bucket is exhausted.

Requires one of the following token scopes: lists.

delete/business/folders/{folderId}

Request

  • Base URL: https://api.tryfuse.ai/api/v1
  • URL: https://api.tryfuse.ai/api/v1/business/folders/{folderId}
  • Auth: HTTP basic

Path parameters

folderIdstring required

24-character hex id of the folder (from GET /business/folders).

Query parameters

type'contactList' | 'companyList' | 'campaign' | 'agent'

Kind of the folder being changed: required as campaign or agent for those folder kinds; omit (or pass contactList/companyList) for a list folder, which resolves by id alone.

Response

Deleted

Changes

No recorded changes to this operation across all 1 revision of this API.