Availability
Workspace creation, rename, access changes, and deletion are human administrative decisions unless a verified tool explicitly exposes the operation. A workspace is a place inside a team that groups artifacts and has its own access list. Do not claim to perform UI-only workspace administration.
Lifecycle invariants
| Operation | Constraint |
|---|---|
| Create | Requires a team role that permits workspace administration |
| Rename | Changes the display name, not workspace ID, artifacts, grants, or billing |
| Delete | General, the built-in workspace created with the team, cannot be deleted; additional workspaces must satisfy content restrictions |
| Place artifact | Requires create/import permission in the destination |
| Move artifact | Requires sufficient source and destination workspace access |
Agent placement route
- Discover reachable workspaces and IDs with
anima workspaces. A reachable workspace is one the agent has permission to access. - Confirm the human-selected destination.
- Supply the workspace ID to supported creation, import, or duplication operations.
- Verify the resulting artifact appears in that workspace.
anima create --workspace <id> selects a destination. Omission is valid only when the agent can create in exactly one workspace; otherwise no default exists.
Move semantics
A same-team workspace move changes the access list governing the artifact. It does not create a copy. A destination in another team requires duplication or import as a separate artifact. Never report a cross-team copy as a move.
Failures
- Treat source or destination denial as terminal for the attempt. Repeating the same request cannot fix a terminal denial.
- Do not reveal whether an inaccessible workspace or artifact exists.
- Ask a human administrator to review workspace access.
- A create or duplicate is non-idempotent: repeating it may create another artifact. After a lost response, list recent artifacts before retrying.