# Replace a parser | Parsium Docs

Source: https://docs.parseium.com/api/operations/updateparser/

# Replace a parser

PUT

/v1/parsers/{id}

Full replacement, not a patch. v1 and v2 config formats cannot be mixed.

## Authorizations

 Section titled “Authorizations ”

- **[apiKeyHeader](/api/#apikeyheader)**
- **[apiKeyQuery](/api/#apikeyquery)**

## Parameters

 Section titled “
Parameters
”

### Path Parameters

 Section titled “Path Parameters ”

 id

required

 string

Parser ID

## Request Body
required

 Section titled “Request Body
required
 ”

 Select media type application/json

 object

 name

Required unless `config.name` supplies it.

 string

 <= 120 characters

 description

required

Required human/agent-readable purpose.

 string

 url

Optional documentation URL for the resource.

 string format: uri

 config

required

A v2 flat parser config. See the [Parsers guide](/guides/parsers/) for HTML, JSON, API, regex, list mode, field typing, and transforms.

 object

 name

 string

 type

required

 string

Allowed values: html json api regex

 fields

required

 Array<object>

 >= 1 items <= 64 items

 object

 key

additional properties

any

 item_selector

 string

 item_selector_type

 string

Allowed values: css xpath

 item_path

 string

 json_source

 object

 key

additional properties

any

 key

additional properties

any

 scrape_config

Fetch override. Credit price depends on browser and proxy settings.

 object

 useBrowser

 boolean

 waitSeconds

 number

 waitForBrowser

 string

 proxy

`default`, `highquality`, `hardcore`, `premium`, or `premium:<country code>`.

 string

 visibility

 string

 default: private

Allowed values: private public

## Responses

 Section titled “
Responses
”

### 200

 Section titled “200 ”

Parser replaced.

 Select media type application/json

 object

 id

 string

 name

 string

 format

 string

 version

 integer

 updated_at

 string format: date-time

### 401

 Section titled “401 ”

Missing or invalid API key.

 Select media type application/json

 object

 error

required

 string

##### Example

```
invalid request
```

 field

Field that failed validation.

 string

 detail

 string

 hint

 string

### 404

 Section titled “404 ”

Resource missing or not owned by this account.

 Select media type application/json

 object

 error

required

 string

##### Example

```
invalid request
```

 field

Field that failed validation.

 string

 detail

 string

 hint

 string

### 422

 Section titled “422 ”

Validation failed.

 Select media type application/json

 object

 error

required

 string

##### Example

```
invalid request
```

 field

Field that failed validation.

 string

 detail

 string

 hint

 string