# Update

Launch stage: Beta

`PATCH /api/2.1/unity-catalog/{name=software-artifacts/*}`

Updates a software artifact. The name is immutable; only the owner may be changed.
 The destination owner must exist in the account. The caller needs MANAGE_ACCESS_CONTROL
 on the artifact. The response contains its name and the requested owner; audit fields are omitted.

API scopes: unity-catalog

## Path parameters

- `name` (string, required, ID, Immutable)
  Resource name of the artifact, of the form
   `software-artifacts/{catalog}.{schema}.{artifact}`.

## Query parameters

- `update_mask` (string, required)
  Fields to update, relative to `software_artifact`. Accepts `owner` or `*`; owner is the only
   mutable field, so both select the same update. Output-only values in the resource are ignored.

## Request body

The software artifact to update. Its name identifies the existing artifact; only owner may be
 changed.
- `owner` (string, optional)
  Principal name (a user, service principal, or group) that owns this artifact.

## Returns

Returns the SoftwareArtifact object.

## Response

```json
{
  "name": "string",
  "owner": "string",
  "create_time": "string",
  "created_by": "string",
  "update_time": "string",
  "updated_by": "string"
}
```