# API Reference Editor
Scalar API references with an integrated editor. The editor can be used in two ways:
## Internal State Management
You (optionally) provide an initial value and the editor will manage any changes internally.
```html
API Reference Editor
```
## External State Management
To have additional control over when the references are updated you can provide a `configuration.spec.content` value and then handle the custom event that is emitted from the Editor component. A handler can be passed directly to the mountApiReferenceEditable function or you can attach an event listener for `scalar-update` to the mounted div.
If you wish to have external UI that updates the spec then `updateSpecValue` can be used to force update the content.
```html
API Reference Editor
```