> ## Documentation Index
> Fetch the complete documentation index at: https://docs.staging.alpic.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# submission update

> Update the fields of a submission package

Update the fields of a submission package. Only the fields you pass are changed, so you can send one field without restating the rest.

The platform is read from the package itself. It is fixed when the package is created and cannot be changed.

A field name the platform does not have is rejected rather than ignored, so a typo fails the call instead of being
silently dropped.

<Note>
  Because fields are merged, this command cannot unset a field. Send an empty value (`""` or `[]`) to blank one.
</Note>

## Usage

```bash theme={null}
alpic submission update --submission-id <submissionId> --form-data-file ./submission.json
```

## Extended Usage

Pass the fields inline:

```bash theme={null}
alpic submission update --submission-id <submissionId> --form-data '{"appName":"Chess"}'
```

Read the fields from standard input, so a script can build the payload:

```bash theme={null}
jq -n '{tagline: "Play chess in the conversation"}' \
  | alpic submission update --submission-id <submissionId> --form-data-file -
```

## Options

| Flag                | Description                                                                        | Default |
| ------------------- | ---------------------------------------------------------------------------------- | ------- |
| `--submission-id`   | The ID of the submission package.                                                  | —       |
| `--form-data`       | The submission fields as a JSON object.                                            | —       |
| `--form-data-file`  | Path to a JSON file holding the submission fields; use `-` to read standard input. | —       |
| `--json`            | Print the unmodified API response as JSON.                                         | `false` |
| `--non-interactive` | Skip interactive prompts.                                                          |         |
