---
title: "Update a provider specification"
method: PATCH
path: "/provider_specification/{id}"
tags: ["Provider Specification"]
---

# Update a provider specification

`PATCH /provider_specification/{id}`

Update an existing provider specification

## Path parameters

- `id` string, uuid, required — Unique identifier for the entity represented as a UUID

## Request body

- object — Object to update a provider specification
  - `name` string — Name of the provider specification
  - `icon` string — Icon for the provider specification
  - `description` string — Description of the provider specification
  - `visible_to` string[] — List of NRNs this specification is visible to
  - `schema` object — [JSON Schema](https://json-schema.org/overview/what-is-jsonschema) for the provider specification. This schema defines settings for any [nullplatform integrations](/docs/providers/supported-integrations). It can also include custom JSON Schema keywords such as: • **tag** (boolean): Marks a property as auto-taggable, automatically creating a tag with the property's value. • **secret** (boolean): Marks a property as secret, ensuring the property's value is never revealed. • **groups** (array): Specifies configuration groups within the schema, automatically creating sections in the UI.
  - `allow_dimensions` boolean — Flag to allow dimensions for this specification
  - `default_dimensions` object — Default dimensions for the provider specification
  - `category` string — Category slug to associate with this specification. Valid values: logging, metrics, cloud-providers, code-repository, assets-repository, container-orchestration, compute-management, vpc

## Response `2XX`

Object representing a provider specification resource

- object — Object representing a provider specification resource
  - `id` string, uuid, required — Unique identifier for the entity represented as a UUID
  - `name` string, required — Name of the provider specification
  - `slug` string, required — Unique slug for the provider specification
  - `icon` string — Icon for the provider specification
  - `description` string — Description of the provider specification
  - `visible_to` string[] — List of NRNs this specification is visible to
  - `schema` object, required — [JSON Schema](https://json-schema.org/overview/what-is-jsonschema) for the provider specification. This schema defines settings for any [nullplatform integrations](/docs/providers/supported-integrations). It can also include custom JSON Schema keywords such as: • **tag** (boolean): Marks a property as auto-taggable, automatically creating a tag with the property's value. • **secret** (boolean): Marks a property as secret, ensuring the property's value is never revealed. • **groups** (array): Specifies configuration groups within the schema, automatically creating sections in the UI.
  - `allow_dimensions` boolean, required — Flag to allow dimensions for this specification
  - `default_dimensions` object — Default dimensions for the provider specification
  - `tags` object[] — Tags associated with the providers
    - `key` string, required — Tag key
    - `value` string, required — Tag value
    - `id` string, uuid, required — Unique identifier for the entity represented as a UUID
  - `categories` Def0[] — IDs of associated categories
  - `dependencies` Def0[] — IDs of associated dependencies
  - `organization_id` integer, nullable — Organization ID that owns this specification. NULL means global (nullplatform-managed)
  - `created_at` string, date-time, required — Creation timestamp
  - `updated_at` string, date-time, required — Last update timestamp

## Other responses

- `4XX` — Format for representing errors during API interactions
- `5XX` — Format for representing errors during API interactions

---

[API](https://skmtc.dev/nullplatform/apis/nullplatform-api.md) · [All operations](https://skmtc.dev/nullplatform/apis/nullplatform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nullplatform/nullplatform-api/revisions/1c4ea154b159/schema)