---
id: provider-specification-create
title: "Create a provider specification"
description: "Create a new provider specification for your organization"
sidebar_label: "Create a provider specification"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "post api-method"
info_path: docs/api/providers
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Create a provider specification"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/provider_specification"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Create a new provider specification for your organization

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={undefined}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"title":"ProviderSpecificationCreate","description":"Object to create a new provider specification","properties":{"name":{"type":"string","description":"Name of the provider specification"},"icon":{"type":"string","description":"Icon for the provider specification"},"description":{"type":"string","description":"Description of the provider specification"},"visible_to":{"type":"array","items":{"type":"string"},"description":"List of NRNs this specification is visible to"},"schema":{"type":"object","description":"[JSON Schema](https://json-schema.org/overview/what-is-jsonschema) for the provider specification.\nThis schema defines settings for any [nullplatform integrations](/docs/providers/supported-integrations).\nIt can also include custom JSON Schema keywords such as:\n\n• **tag** (boolean): Marks a property as auto-taggable, automatically creating a tag with the property's value.\n\n• **secret** (boolean): Marks a property as secret, ensuring the property's value is never revealed.\n\n• **groups** (array): Specifies configuration groups within the schema, automatically creating sections in the UI.\n"},"allow_dimensions":{"type":"boolean","description":"Flag to allow dimensions for this specification"},"default_dimensions":{"type":"object","description":"Default dimensions for the provider specification"},"category":{"type":"string","description":"Category slug to associate with this specification. Valid values: logging, metrics, cloud-providers, code-repository, assets-repository, container-orchestration, compute-management, vpc"}},"example":{},"required":["name","schema","visible_to"]}}},"description":"Object to create a new provider specification"}}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"2XX":{"description":"Object representing a provider specification resource","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"name":{"type":"string","description":"Name of the provider specification"},"slug":{"type":"string","description":"Unique slug for the provider specification"},"icon":{"type":"string","description":"Icon for the provider specification"},"description":{"type":"string","description":"Description of the provider specification"},"visible_to":{"type":"array","items":{"type":"string"},"description":"List of NRNs this specification is visible to"},"schema":{"type":"object","description":"[JSON Schema](https://json-schema.org/overview/what-is-jsonschema) for the provider specification.\nThis schema defines settings for any [nullplatform integrations](/docs/providers/supported-integrations).\nIt can also include custom JSON Schema keywords such as:\n\n• **tag** (boolean): Marks a property as auto-taggable, automatically creating a tag with the property's value.\n\n• **secret** (boolean): Marks a property as secret, ensuring the property's value is never revealed.\n\n• **groups** (array): Specifies configuration groups within the schema, automatically creating sections in the UI.\n"},"allow_dimensions":{"type":"boolean","description":"Flag to allow dimensions for this specification"},"default_dimensions":{"type":"object","description":"Default dimensions for the provider specification"},"tags":{"type":"array","description":"Tags associated with the providers","items":{"type":"object","properties":{"key":{"type":"string","description":"Tag key"},"value":{"type":"string","description":"Tag value"},"id":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"}},"required":["key","value","id"],"additionalProperties":false}},"categories":{"type":"array","items":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"description":"IDs of associated categories"},"dependencies":{"type":"array","items":{"title":"Id","type":"string","format":"uuid","description":"Unique identifier for the entity represented as a UUID"},"description":"IDs of associated dependencies"},"organization_id":{"type":"integer","nullable":true,"description":"Organization ID that owns this specification. NULL means global (nullplatform-managed)"},"created_at":{"type":"string","format":"date-time","description":"Creation timestamp"},"updated_at":{"type":"string","format":"date-time","description":"Last update timestamp"}},"title":"ProviderSpecificationRead","description":"Object representing a provider specification resource","required":["id","name","slug","schema","allow_dimensions","created_at","updated_at"]}}}},"4XX":{"description":"Format for representing errors during API interactions","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code indicating the error"},"code":{"type":"string","description":"Unique error code for reference and categorization"},"error":{"type":"string","description":"Short, human-readable error type or category"},"message":{"type":"string","description":"Detailed error message providing additional context"}},"description":"Format for representing errors during API interactions","required":["statusCode","error","message"]}}}},"5XX":{"description":"Format for representing errors during API interactions","content":{"application/json":{"schema":{"title":"Error","type":"object","properties":{"statusCode":{"type":"number","description":"HTTP status code indicating the error"},"code":{"type":"string","description":"Unique error code for reference and categorization"},"error":{"type":"string","description":"Short, human-readable error type or category"},"message":{"type":"string","description":"Detailed error message providing additional context"}},"description":"Format for representing errors during API interactions","required":["statusCode","error","message"]}}}}}}
>
  
</StatusCodes>