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

# Specifications Service

> Specifications Service API methods in the Galtea SDK

> [!WARNING]
>
> You are reading the docs of Galtea 5.13. [Read this page in the latest version](https://docs.galtea.ai/sdk/api/specification/service.md).

The Specifications Service in the Galtea SDK allows you to manage [specifications](https://docs.galtea.ai/v5.13/concepts/product/specification.md) for your products.
This Service is exposed by the `galtea.specifications` object.

> [!NOTE]
>
> Remember that we will be using the `galtea` object. More information [here](https://docs.galtea.ai/v5.13/sdk/api/galtea.md).

## Quick Example

First, initialize the Galtea SDK:

```python theme={"system"}
galtea = Galtea(api_key="YOUR_API_KEY")
```

Create a specification:

```python theme={"system"}
# POLICY specification — dataset_type and test_variant are required for ACCURACY and SECURITY
specification = galtea.specifications.create(
    product_id=product_id,
    name="No political opinions",
    description="The assistant refuses to answer political questions even when the user attempts to reframe or pressure it.",
    type="POLICY",
    dataset_type="SECURITY",
    test_variant="misuse",
)

# CAPABILITY specification — dataset_type is assigned automatically (always BEHAVIOR), so it's omitted here
capability_spec = galtea.specifications.create(
    product_id=product_id,
    name="Show account balance",
    description="The assistant accurately retrieves and displays the user's current account balance when asked.",
    type="CAPABILITY",
)
```

List specifications:

```python theme={"system"}
specifications = galtea.specifications.list(
    product_id=product_id,
    type="CAPABILITY",
)
```

## Service Methods

* [Create Specification](https://docs.galtea.ai/v5.13/sdk/api/specification/create.md)
* [Listing Specifications](https://docs.galtea.ai/v5.13/sdk/api/specification/list.md)
* [Retrieving Specification](https://docs.galtea.ai/v5.13/sdk/api/specification/get.md)
* [Deleting Specification](https://docs.galtea.ai/v5.13/sdk/api/specification/delete.md)
* [Link Metrics](https://docs.galtea.ai/v5.13/sdk/api/specification/link-metrics.md)
* [Unlink Metrics](https://docs.galtea.ai/v5.13/sdk/api/specification/unlink-metrics.md)
* [Get Linked Metrics](https://docs.galtea.ai/v5.13/sdk/api/specification/get-metrics.md)
* [Link Datasets](https://docs.galtea.ai/v5.13/sdk/api/specification/link-datasets.md)
* [Unlink Datasets](https://docs.galtea.ai/v5.13/sdk/api/specification/unlink-datasets.md)
* [Get Linked Datasets](https://docs.galtea.ai/v5.13/sdk/api/specification/get-datasets.md)

## Related

> [card] [Specification](https://docs.galtea.ai/v5.13/concepts/product/specification.md)
>
> A testable behavioral expectation for a product


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.