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

# Access skill parameters via the Vantage API

> Use the Vantage API to access and modify Document and Process skill parameter values.

The Vantage API lets you access Document and Process skill parameters and change their values for a specific transaction. Parameters are passed as key-value string pairs. Values set via the API take precedence over values set in the Vantage UI.

## Change skill parameter values

To change skill parameter values for a transaction, create a new transaction (or launch one) via POST and include the new values in the `skillParameters` body.

Create an empty transaction:

```http theme={null}
POST {your-host}/api/publicapi/v1/transactions
```

Or launch a transaction that runs a specific skill:

```http theme={null}
POST {your-host}/api/publicapi/v1/transactions/launch?skillId={skill-id}
```

Include new parameter values in the request body:

<Tabs>
  <Tab title="Windows">
    ```bat theme={null}
    curl -X POST "{your-host}/api/publicapi/v1/transactions" ^
    -H "Authorization: Bearer {token}" ^
    -H "Content-Type: application/json" ^
    -d "{\"skillId\":\"123\",\"skillParameters\":[{\"key\":\"New parameter\",\"value\":\"Vendors new\"}]}"
    ```
  </Tab>

  <Tab title="Linux">
    ```bash theme={null}
    curl -X POST '{your-host}/api/publicapi/v1/transactions' \
    -H 'Authorization: Bearer {token}' \
    -H 'Content-Type: application/json' \
    -d '{"skillId":"123","skillParameters":[{"key":"New parameter","value":"Vendors new"}]}'
    ```
  </Tab>
</Tabs>

<Note>
  A transaction can have up to 10 key-value skill parameters. Keys are limited to 128 characters; values to 256.
</Note>

## Get skill parameter values

Use one of the following to retrieve skill parameter values.

### Query the skillParameters endpoint

Send a GET request:

```http theme={null}
GET {your-host}/api/publicapi/v1/transactions/{transaction-id}/skillParameters/
```

Response:

```json theme={null}
[
  {
    "key": "New parameter",
    "value": "Vendors"
  }
]
```

### Download the transaction file

Send a GET request to download the transaction file, which contains parameter values in JSON:

```http theme={null}
GET {your-host}/api/publicapi/v1/transactions/{transaction-id}/files/{file-id}/download
```

## Related topics

<CardGroup cols={3}>
  <Card title="Skill parameters" icon="sliders" href="/vantage/documentation/skill-designer/skill-parameters/skill-parameters">
    Configure and manage skill parameters to adjust skill behavior without retraining.
  </Card>

  <Card title="Document skill parameters" icon="file-lines" href="/vantage/documentation/skill-designer/skill-parameters/document-skill-params">
    Configure parameters on a Document skill for different processing scenarios.
  </Card>

  <Card title="Process skill parameters" icon="diagram-project" href="/vantage/documentation/skill-designer/skill-parameters/process-skill-params">
    Access and modify Document skill parameters from a Process skill.
  </Card>

  <Card title="Extract activity" icon="database" href="/vantage/documentation/skill-designer/process/extract-activity">
    Extract field values from documents using a Document skill.
  </Card>

  <Card title="Vantage API introduction" icon="code" href="/vantage/developer/api-introduction">
    Access Vantage programmatically via the REST API.
  </Card>
</CardGroup>