bird assets folders update
Usage
Code example
bird assets folders update <folder-id> [flags]Description
Rename or move a media-library folder
Moves the folder and its descendants without changing asset URLs. Null parent_id moves it to the root. Moving into itself or a descendant is refused, as is a tree deeper than 10 levels.
Build the request from flags, a JSON AssetFolderUpdate body via --body-file ("-" reads stdin), or both — a flag overrides the matching body field. Run --example to print a ready-to-edit body, or --dry-run to print the resolved request without sending it.
Examples
Code example
# print the body shape (no credentials needed)
bird assets folders update --example
# the body it prints:Code example
{
"name": "Brand images"
}Options
Request
| Name | Description |
|---|---|
--body-file | Read the JSON request body from this file; "-" reads stdin |
--example | Print a complete example request body, then exit |
--dry-run | Print the resolved request without sending it, then exit |
--idempotency-key | Deduplication key; a retry with the same key won't act twice |
Options
| Name | Description |
|---|---|
--name | The folder's display name. Must be unique among folders sharing the same parent, compared without regard to case. Cannot contain /. |
--parent-id | The folder to move this one into. Send null to move it to the top level of the library. A folder cannot be moved into itself or into one of its own subfolders. |
--response-schema | Print the fields this command returns, then exit |
Related
| Name | Description |
|---|---|
bird assets folders create | Create a folder in the media library |
bird assets folders delete | Delete a folder and move its contents up |
bird assets folders get | Get a media-library folder by ID |
bird assets folders list | List workspace media-library folders |
Related resources
Continue with the documentation, guides and examples for this topic.