# Create a new wallet action (unsigned transaction).

> For the complete documentation index, see [llms.txt](https://bsvblockchain.com/docs/llms.txt).

**POST** `/actions`

Base URL: `https://{host}/storage/v1`

Corresponds to `StorageProvider.createAction(auth, args)`.
Allocates inputs and outputs for a new transaction; returns the
data the SDK needs to construct and sign the raw transaction.

## Body

Content type: `application/json`

- `args` (object, required)
  BRC-100 ValidCreateActionArgs (see brc-100-wallet.json for full schema).

Example:

```json
{
  "args": {}
}
```

## Responses

### 200

Action creation result.

- `inputBeef` (integer[])
- `inputs` (object[], required)
  - `vin` (integer, required)
  - `sourceTxid` (string, required)
  - `sourceVout` (integer, required)
  - `sourceSatoshis` (integer, required)
  - `sourceLockingScript` (string, required)
    Hex-encoded locking script.
  - `sourceTransaction` (integer[])
  - `unlockingScriptLength` (integer, required)
  - `providedBy` ("you" | "storage" | "you-and-storage", required)
  - `type` (string, required)
  - `spendingDescription` (string)
  - `derivationPrefix` (string)
  - `derivationSuffix` (string)
  - `senderIdentityKey` (string)
- `outputs` (object[], required)
  - `vout` (integer, required)
  - `providedBy` ("you" | "storage" | "you-and-storage", required)
  - `purpose` (string)
  - `derivationSuffix` (string)
  - `satoshis` (integer, required)
  - `lockingScript` (string, required)
- `noSendChangeOutputVouts` (integer[])
- `derivationPrefix` (string, required)
- `version` (integer, required)
- `lockTime` (integer, required)
- `reference` (string, required)

Example:

```json
{
  "inputBeef": [
    0
  ],
  "inputs": [
    {
      "vin": 0,
      "sourceTxid": "string",
      "sourceVout": 0,
      "sourceSatoshis": 0,
      "sourceLockingScript": "string",
      "sourceTransaction": [
        0
      ],
      "unlockingScriptLength": 0,
      "providedBy": "you",
      "type": "string",
      "spendingDescription": "string",
      "derivationPrefix": "string",
      "derivationSuffix": "string",
      "senderIdentityKey": "string"
    }
  ],
  "outputs": [
    {
      "vout": 0,
      "providedBy": "you",
      "purpose": "string",
      "derivationSuffix": "string",
      "satoshis": 0,
      "lockingScript": "string"
    }
  ],
  "noSendChangeOutputVouts": [
    0
  ],
  "derivationPrefix": "string",
  "version": 0,
  "lockTime": 0,
  "reference": "string"
}
```

### 400

Bad request — invalid arguments.

- `error` (string, required)
- `code` (string)
  Machine-readable error code (see specs/errors.md).

Example:

```json
{
  "error": "string",
  "code": "string"
}
```

### 401

Authentication required or token invalid.

- `error` (string, required)
- `code` (string)
  Machine-readable error code (see specs/errors.md).

Example:

```json
{
  "error": "string",
  "code": "string"
}
```

### 500

Internal storage error.

- `error` (string, required)
- `code` (string)
  Machine-readable error code (see specs/errors.md).

Example:

```json
{
  "error": "string",
  "code": "string"
}
```