# LibTmux::X::Creation

- **Module:** LibTmux::X
- **Package:** LibTmux
- **Language:** Perl
- **Kind:** exception
- **Source:** https://github.com/libtmux/libtmux-perl/blob/352715a4fa66a96eed7763b90daaa536aa2f121d/packages/core/lib/LibTmux/X.pm#L59
- **Bases:** [`LibTmux::X`](/en/perl/latest/reference/libtmux-x/)
- **Page:** https://libtmux.org/en/perl/latest/reference/libtmux-x-creation/

```
package LibTmux::X::Creation;
```

A creation command succeeded but subsequent receipt decoding or capture failed. `created` returns a minimal generation-scoped entity handle when the command's receipt was decoded; other fields remain unloaded. `cause` preserves the original acquisition failure. `dispatched` is true. The returned handle permits explicit, generation-checked cleanup; absent receipts leave effects uncertain. See [`"new_session" in LibTmux::Server`](/en/perl/latest/reference/libtmux-server-new_session/).

## Members

### Common operations

- [`cause`](/en/perl/latest/reference/libtmux-x-creation-cause/) (method): Return the original acquisition exception for [`"Creation" in LibTmux::X`](/en/perl/latest/reference/libtmux-x-creation/).

### Other members

- [`created`](/en/perl/latest/reference/libtmux-x-creation-created/) (method): Creation failures expose a minimal generation-scoped entity receipt, or undef. Only [`"Creation" in LibTmux::X`](/en/perl/latest/reference/libtmux-x-creation/) provides this method.

## Inherited members

- [`count`](/en/perl/latest/reference/libtmux-x-creation-count/) (method), inherited from `LibTmux::X`: Return the observed cardinality lower bound where applicable.
- [`details`](/en/perl/latest/reference/libtmux-x-creation-details/) (method), inherited from `LibTmux::X`: Return a fresh shallow hashref of diagnostic fields. Causes and entity handles retain their identity.
- [`dispatched`](/en/perl/latest/reference/libtmux-x-creation-dispatched/) (method), inherited from `LibTmux::X`: Return whether the request was submitted where known; undef means no dispatch evidence was recorded. This never proves rollback.
- [`entity`](/en/perl/latest/reference/libtmux-x-creation-entity/) (method), inherited from `LibTmux::X`: Return the entity kind, or undef when inapplicable.
- [`expected`](/en/perl/latest/reference/libtmux-x-creation-expected/) (method), inherited from `LibTmux::X`: Return the expected operand description, or undef.
- [`matched_ids`](/en/perl/latest/reference/libtmux-x-creation-matched_ids/) (method), inherited from `LibTmux::X`: Return a fresh arrayref of observed matching IDs, including duplicate occurrences.
- [`message`](/en/perl/latest/reference/libtmux-x-creation-message/) (method), inherited from `LibTmux::X`: Return the human-readable failure description.
- [`new`](/en/perl/latest/reference/libtmux-x-creation-new/) (method), inherited from `LibTmux::X`: `new(%details)` constructs an exception object without throwing or I/O.
- [`path`](/en/perl/latest/reference/libtmux-x-creation-path/) (method), inherited from `LibTmux::X`: Return the criterion or argument path, or undef when inapplicable.
- [`received`](/en/perl/latest/reference/libtmux-x-creation-received/) (method), inherited from `LibTmux::X`: Return the received operand description, or undef.
- [`result`](/en/perl/latest/reference/libtmux-x-creation-result/) (method), inherited from `LibTmux::X`: Return a completed or bounded partial [`LibTmux::CommandResult`](/en/perl/latest/reference/libtmux-commandresult/), or undef before process dispatch.
- [`throw`](/en/perl/latest/reference/libtmux-x-creation-throw/) (method), inherited from `LibTmux::X`: `throw(%details)` throws one exception object of the receiving class.

## Guides

Pages that discuss `Creation`.

- [Errors and recovery](/en/perl/latest/topics/errors/)