> ## Documentation Index > Fetch the complete documentation index at: https://docs.ankra.ai/llms.txt > Use this file to discover all available pages before exploring further. # Create an OVH cluster ## OpenAPI ````yaml https://platform.ankra.app/openapi.json post /api/v1/clusters/ovh openapi: 3.1.0 info: title: FastAPI version: 0.1.0 servers: - url: https://platform.ankra.app security: [] tags: - name: Clusters description: Create, inspect and manage clusters, and the stacks deployed on them. - name: Managed Clusters description: Provider-managed control planes, driven through one common surface. - name: Imported Clusters description: Clusters that already existed and were connected to Ankra. - name: Cluster Access description: Kubeconfigs, service-account tokens and per-cluster access grants. - name: Kubernetes description: Read and act on the Kubernetes objects inside a cluster. - name: DigitalOcean Clusters description: Provision and manage DigitalOcean Kubernetes clusters. - name: Hetzner Clusters description: Provision and manage Hetzner Kubernetes clusters. - name: OVH Clusters description: Provision and manage OVH Kubernetes clusters. - name: Scaleway Clusters description: Provision and manage Scaleway Kapsule clusters. - name: UpCloud Clusters description: Provision and manage UpCloud Kubernetes clusters. - name: Applications description: Deploy, configure and observe applications across the fleet. - name: Stack Profiles description: Reusable stack definitions, their versions and sharing. - name: Charts description: Browse the chart catalogue behind stacks and addons. - name: Helm description: Helm registries, credentials and the charts they expose. - name: Executions description: Long-running platform executions and their jobs. - name: Operations description: Cancel in-flight cluster operations and their jobs. - name: Chat description: Conversational sessions, plans and confirmable actions. - name: AI Agent Runs description: Autonomous agent runs and their outcomes. - name: AI Tickets description: The AI ticket board, its sync connections and settings. - name: AI Playbooks description: Reusable playbooks the AI lanes execute. - name: AI Conditions description: Conditions that gate AI autonomy. - name: AI Engineering Handoffs description: Work the AI lanes escalate to a human engineer. - name: AI Environment description: The environment and base stacks AI demos deploy into. - name: Security description: Findings, advisories, SBOMs, compliance and posture. - name: Cost description: Cluster and fleet cost, rate cards and cost settings. - name: Billing description: Subscription and spend caps. - name: Organisation description: Members, invitations, audit logs and organisation settings. - name: Account Tokens description: Personal access tokens for the API and CLI. - name: Credentials description: The shared credential store. - name: Azure Credentials description: Azure credentials and SSH keys. - name: DigitalOcean Credentials description: DigitalOcean credentials and SSH keys. - name: Hetzner Credentials description: Hetzner credentials and SSH keys. - name: OVH Credentials description: OVH credentials and SSH keys. - name: Scaleway Credentials description: Scaleway credentials. - name: UpCloud Credentials description: UpCloud credentials and SSH keys. - name: Data Source Credentials description: Credentials for metrics and log sources. - name: DNS Credentials description: Credentials for DNS providers. - name: DNS description: DNS zones and records, including custom organisation zones. - name: Cloudflare description: Cloudflare domains and the credentials behind them. - name: Variables description: Organisation- and cluster-scoped variables. - name: SOPS description: Encrypt and decrypt values with the organisation SOPS config. - name: Alerts description: Alert integrations and ingest credentials. - name: Notifications description: Notification routes and their delivery targets. - name: Support description: Support tickets. paths: /api/v1/clusters/ovh: post: tags: - OVH Clusters summary: Create an OVH cluster operationId: create_ovh_cluster_endpoint_api_v1_clusters_ovh_post parameters: - in: header name: authorization required: false schema: anyOf: - type: string - type: 'null' title: Authorization - in: header name: x-ankra-organisation-id required: false schema: anyOf: - type: string - type: 'null' title: X-Ankra-Organisation-Id requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateOvhClusterRequest' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/CreateOvhClusterResponse' description: Cluster created successfully '400': description: Invalid request '401': description: Unauthorized '404': description: Not found '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error components: schemas: CreateOvhClusterRequest: properties: availability_zones: title: Availability Zones type: array items: type: string description: >- 3-AZ regions only: spread the cluster across these availability zones (e.g. eu-west-par-a/b/c). Control planes and etcd are distributed per role, workers per node group. Omitted leaves placement to OVH, which places the whole cluster in one zone. More than one zone requires at least 3 control planes for etcd quorum. cni: description: >- Container network. Omitted resolves to cilium on kubeadm (the default distribution) and flannel on k3s. enum: - flannel - calico - cilium title: Cni type: string control_plane_count: default: 1 title: Control Plane Count type: integer control_plane_flavor_id: default: b3-16 title: Control Plane Flavor Id type: string credential_id: format: uuid4 title: Credential Id type: string criticality: anyOf: - enum: - production - staging - development - disposable type: string - type: 'null' title: Criticality description: anyOf: - type: string - type: 'null' title: Description dhcp_end: default: 10.0.1.200 title: Dhcp End type: string dhcp_start: default: 10.0.1.100 title: Dhcp Start type: string distribution: default: kubeadm title: Distribution type: string environment: anyOf: - maxLength: 50 minLength: 1 type: string - type: 'null' title: Environment etcd_flavor_id: default: b3-16 title: Etcd Flavor Id type: string etcd_node_count: default: 3 title: Etcd Node Count type: integer etcd_topology: default: stacked title: Etcd Topology type: string external_cloud_provider: default: true title: External Cloud Provider type: boolean gateway_flavor_id: default: c3-4 title: Gateway Flavor Id type: string gateway_model: default: s enum: - s - m - l - xl - 2xl - 3xl title: Gateway Model type: string gitops_branch: default: master title: Gitops Branch type: string gitops_credential_name: anyOf: - type: string - type: 'null' title: Gitops Credential Name gitops_repository: anyOf: - type: string - type: 'null' title: Gitops Repository include_networking: default: true title: Include Networking type: boolean kubernetes_version: anyOf: - type: string - type: 'null' title: Kubernetes Version name: title: Name type: string network_vlan_id: default: 0 title: Network Vlan Id type: integer node_groups: anyOf: - items: $ref: '#/components/schemas/CreateOvhNodeGroupRequest' type: array - type: 'null' title: Node Groups region: title: Region type: string ssh_key_credential_id: format: uuid4 title: Ssh Key Credential Id type: string subnet_cidr: default: 10.0.1.0/24 title: Subnet Cidr type: string worker_count: default: 1 title: Worker Count type: integer worker_flavor_id: default: b3-16 title: Worker Flavor Id type: string required: - name - credential_id - ssh_key_credential_id - region title: CreateOvhClusterRequest type: object CreateOvhClusterResponse: properties: cluster_id: format: uuid4 title: Cluster Id type: string name: title: Name type: string required: - cluster_id - name title: CreateOvhClusterResponse type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object CreateOvhNodeGroupRequest: properties: availability_zone: title: Availability Zone type: string description: >- OVH 3-AZ regions only: pin every node of this group to one availability zone (e.g. eu-west-par-b). Omitted spreads the group across the cluster's zones. count: default: 1 title: Count type: integer instance_type: title: Instance Type type: string labels: additionalProperties: type: string title: Labels type: object name: title: Name type: string taints: items: $ref: '#/components/schemas/NodeTaint' title: Taints type: array user_data: title: User Data type: string description: >- OVH only: opaque cloud-init user data applied verbatim at first boot by every instance the group ever creates, replacements included. Max 65535 bytes. required: - name - instance_type title: CreateOvhNodeGroupRequest type: object ValidationError: properties: loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Error Type type: string required: - loc - msg - type title: ValidationError type: object NodeTaint: properties: effect: enum: - NoSchedule - PreferNoSchedule - NoExecute title: Effect type: string key: type: string title: Key value: default: '' title: Value type: string required: - key - effect title: NodeTaint type: object ````