# Update sandbox template metadata

Source: <https://everruns.com/docs/api/operations/update_sandbox_template_metadata/>

[Docs](https://everruns.com/docs/)/[API reference](https://everruns.com/docs/api/)/[Operations & billing](https://everruns.com/docs/api/groups/operations-billing/)/Update sandbox template metadata

# Update sandbox template metadata

Preview

Update Sandbox Template metadata while preserving its current execution specification.

Public APIEverruns Cloud and self-hosted Platform

PATCH`/v1/sandbox-template-metadata/{id}`

See [authentication](https://everruns.com/docs/sre/runbooks/authentication/) for credentials and permissions.

## Parameters

### Path Parameters

**id**

required

string

Prefixed public identifier

## Request Bodyrequired

Media typeapplication/json

Editable template metadata; omitted fields retain their current values.

object

**description**

string | null

**display_name**

string | null

### Example generated

```json
{
  "description": "example",
  "display_name": "example"
}
```

## Responses

200Success

### 200

Success

Media typeapplication/json

Editable Sandbox Template labels and metadata, excluding execution configuration.

object

**description**

string | null

**display_name**

required

string

**id**

required

Prefixed identifier with ‘sbxtpl’ prefix

string

/^sbxtpl\_\[0-9a-f]{32}$/

### Example

```json
{
  "id": "sbxtpl_01933b5a000070008000000000000001"
}
```

FetchcURL

Request

```js
const url = 'https://app.everruns.com/api/v1/sandbox-template-metadata/example';
const options = {
  method: 'PATCH',
  headers: {'Content-Type': 'application/json'},
  body: '{"description":"example","display_name":"example"}'
};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

Request

```sh
curl --request PATCH \
  --url https://app.everruns.com/api/v1/sandbox-template-metadata/example \
  --header 'Content-Type: application/json' \
  --data '{ "description": "example", "display_name": "example" }'
```

Additional language examples require JavaScript. The default request example is available above.

200

200 · Success

```json
{
  "display_name": "string",
  "id": "sbxtpl_01933b5a000070008000000000000001"
}
```

## Matching endpoints