Remove app from folder
<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>
Takes an app out of a folder. The app stays in the workspace. Removing an app that isn't in the folder succeeds and changes nothing.
You can change your own personal folders. Workspace folders need the editor role or higher, and any editor can change any workspace folder. A folder that doesn't exist, or another user's personal folder, returns a 404 with the code folder_not_found. A personal access token limited to selected apps can only use the apps it lists. Any other app ID returns a 404.
This is limited to 600 requests per minute. A signed-in session has its own limit, and every personal access token for the workspace shares one. Some workspaces have a different limit.
<Note>Call this with a personal access token sent as a Bearer token, or from a signed-in session. A token works on its own workspace's folders. Workspace API keys aren't accepted, and a read-only token is refused.</Note>
Path parameters
ID of the folder to remove the app from. Get it from id in List app folders.
ID of the folder to remove the app from. Get it from id in List app folders.
ID of the app to take out of the folder.
ID of the app to take out of the folder.
Response
The app isn't in the folder anymore.
Example response
{
"unlinked": true,
"folder_id": "68c1f2a9b4e7d3005a2c9e11",
"app_id": "6820f3a4e7b91d003c45a1f2"
}Changes
Changed in 1 of the 40 revisions of this API.1
- ○
endpoint added
endpoint-added
- ○