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

# Create new cable

> Operation is used to create new cable. Available from product version 3.2.6.

Note: When creating cable with length, measure ID is required.


## OpenAPI

````json POST /cables/
{
  "info": {
    "contact": {
      "email": "keypro@keypro.fi",
      "name": "Keypro Oy",
      "url": "https://keypro.fi/"
    },
    "license": {
      "name": "Copyright (C) Keypro Oy. All rights reserved.",
      "url": "https://www.keypro.fi/"
    },
    "termsOfService": "https://www.keypro.fi/en/terms-of-service",
    "title": "KeyCom REST API",
    "version": "2.0.0"
  },
  "tags": [
    {
      "description": "Plan related operations.",
      "name": "Plan"
    },
    {
      "description": "FreeArea related operations.",
      "name": "FreeArea"
    },
    {
      "description": "FreeLine related operations.",
      "name": "FreeLine"
    },
    {
      "description": "FreeText related operations.",
      "name": "FreeText"
    },
    {
      "description": "FreeText component related operations.",
      "name": "FreeTextComponent"
    },
    {
      "description": "Building address related operations.",
      "name": "Address"
    },
    {
      "description": "Building apartments related operations.",
      "name": "Apartment"
    },
    {
      "description": "Extra attributes related operations.",
      "name": "Extra Attribute"
    },
    {
      "description": "Extra attribute values related operations.",
      "name": "Extra Value"
    },
    {
      "description": "External documents related operations.",
      "name": "External Document"
    },
    {
      "description": "Attached Documents related operations.",
      "name": "Attached Document"
    },
    {
      "description": "Collection related operations.",
      "name": "Collections"
    },
    {
      "description": "External source system derived apartment related operations.",
      "name": "Source system apartment"
    },
    {
      "description": "External source system derived address related operations.",
      "name": "Source system address"
    },
    {
      "description": "Address aliases related operations",
      "name": "Address alias"
    },
    {
      "description": "TxtConstants related operations.",
      "name": "TxtConstant"
    },
    {
      "description": "Point objects related operations.",
      "name": "Point"
    },
    {
      "description": "Survey Constants related operations.",
      "name": "Survey Constant"
    },
    {
      "description": "Survey Points related operations.",
      "name": "Survey Point"
    },
    {
      "description": "Survey Line Strings related operations.",
      "name": "Survey Line String"
    },
    {
      "description": "Template Catalog related operations.",
      "name": "Template Catalog"
    },
    {
      "description": "Route following related operations.",
      "name": "Route Following"
    },
    {
      "description": "Contact person related operations.",
      "name": "Contact Person"
    },
    {
      "description": "Contact person connection related operations.",
      "name": "Contact Person Connection"
    },
    {
      "description": "Telecom premises related operations.",
      "name": "Telecom premises"
    },
    {
      "description": "Device related operations.",
      "name": "Device"
    },
    {
      "description": "Device Group related operations.",
      "name": "Device Group"
    },
    {
      "description": "Telecom Splice related operations.",
      "name": "Splice"
    },
    {
      "description": "Telecom Conduit related operations.",
      "name": "Telecom Conduit"
    },
    {
      "description": "Operations related to putting Telecom Cables and Ducts into Conduits.",
      "name": "Telecom Conduit Link"
    },
    {
      "description": "Telecom Duct related operations.",
      "name": "Telecom Duct"
    },
    {
      "description": "Operations related to putting Telecom Cables into Ducts.",
      "name": "Telecom Duct Link"
    },
    {
      "description": "Operations related to connecting Conduits and endpoints.",
      "name": "Telecom Conduit Connection"
    },
    {
      "description": "Operations related to connecting Cables and endpoints",
      "name": "Telecom Cable Connection"
    },
    {
      "description": "Operations related to connecting and disconnecting telecom cable threads and device ports",
      "name": "Telecom Thread/Port Connection"
    },
    {
      "description": "Operations related to connecting Telecom Ducts to Telecom Premises or Manhole.",
      "name": "Telecom Duct Connection"
    },
    {
      "description": "Telecom Manhole related operations.",
      "name": "Manhole"
    },
    {
      "description": "Telecom Cable related operations.",
      "name": "Cable"
    },
    {
      "description": "Cable Appendix operations for connecting Cables to loops. Manages the relationship between Cables and loops, automatically adjusting Cable extra_length when appendixes are created, updated, or deleted.",
      "name": "Cable Appendix"
    },
    {
      "description": "Telecom Supercable related operations.",
      "name": "Supercable"
    },
    {
      "description": "Cross connection point related operations.",
      "name": "Cross connection point"
    },
    {
      "description": "Service Area related operations.",
      "name": "Service Area"
    },
    {
      "description": "Exchange Area related operations.",
      "name": "Exchange Area"
    },
    {
      "description": "Telecom Area related operations.",
      "name": "Telecom Area"
    },
    {
      "description": "Routefollower related operations.",
      "name": "Routefollower"
    },
    {
      "description": "Circuit related operations.",
      "name": "Circuit"
    },
    {
      "description": "Circuit installation location related operations.",
      "name": "Circuit Location"
    },
    {
      "description": "Circuit section related operations.",
      "name": "Circuit Section"
    },
    {
      "description": "Circuit reservation data view and search operations.",
      "name": "Circuit Reservation Data"
    },
    {
      "description": "Customer data related operations.",
      "name": "Customer"
    },
    {
      "description": "Passed Services related operations.",
      "name": "Passed Services"
    },
    {
      "description": "Circuit logical reservations related operations.",
      "name": "Circuit Connection"
    },
    {
      "description": "Circuit physical reservations related operations.",
      "name": "Circuit Physical Reservation"
    },
    {
      "description": "Operation used to create new connections.",
      "name": "Create connections"
    },
    {
      "description": "Terminal types related operations.",
      "name": "Terminal type"
    },
    {
      "description": "Logical connections related operations.",
      "name": "Logical connections"
    },
    {
      "description": "Operations provided by micro services.",
      "name": "Circuit Services"
    },
    {
      "description": "Contract related operations.",
      "name": "Contract"
    },
    {
      "description": "Contract link related operations.",
      "name": "Contract Link"
    },
    {
      "description": "Pole related operations.",
      "name": "Pole"
    },
    {
      "description": "Circuit faults related operations.",
      "name": "Circuit faults"
    },
    {
      "description": "Duct groups related operations.",
      "name": "Duct groups"
    },
    {
      "description": "Duct group rows related operations.",
      "name": "Duct group rows"
    },
    {
      "description": "Cable thread related operations.",
      "name": "Threads"
    },
    {
      "description": "Task related operations.",
      "name": "Task"
    },
    {
      "description": "Subregion related operations.",
      "name": "Subregion"
    },
    {
      "description": "SAttribute related operations.",
      "name": "SAttribute"
    },
    {
      "description": "Fault related operations.",
      "name": "Fault"
    },
    {
      "description": "Maintenance history related operations.",
      "name": "Maintenance history"
    },
    {
      "description": "Deflection related operations.",
      "name": "Deflection"
    },
    {
      "description": "Fault Component related operations.",
      "name": "Fault Component"
    },
    {
      "description": "Task comment related operations.",
      "name": "Task Comment"
    },
    {
      "description": "FaultComponentFault related operations.",
      "name": "FaultComponentFault"
    }
  ],
  "paths": {
    "/cables/": {
      "post": {
        "description": "Operation is used to create new cable. Available from product version 3.2.6.\n\nNote: When creating cable with length, measure ID is required.\n",
        "operationId": "createCable",
        "parameters": [
          {
            "description": "cable to be created",
            "in": "body",
            "name": "cable",
            "required": "true",
            "schema": {
              "$ref": "#/definitions/FlatCable"
            }
          }
        ],
        "responses": {
          "201": {
            "description": "A created Cable",
            "examples": {
              "application/json": {
                "automSecLengthCalc": null,
                "batch": "",
                "cableId": "",
                "cableType": "26890",
                "connectedCapacity": null,
                "createdBy": "user@keypro.fi",
                "createdTs": "2020-02-19T12:41:35.995577",
                "endReading": null,
                "extraLength": null,
                "falseCable": null,
                "freeCapacity": null,
                "heightAccuracy": null,
                "historyDate": null,
                "id": "4619570",
                "identification": "Test cable",
                "importance": null,
                "installYear": "1999",
                "installationType": "3230",
                "length": null,
                "location": "LINESTRING Z (453950.3968999999924563 6702355.8256999999284744 0.0000000000000000, 453906.3121999999857508 6702314.9418999999761581 0.0000000000000000, 453882.1871999999857508 6702293.8472999995574355 0.0000000000000000, 453840.5094999999855645 6702261.6430000001564622 0.0000000000000000, 453799.4174999999813735 6702227.8823999995365739 0.0000000000000000, 453759.3870999999926426 6702197.4374000001698732 0.0000000000000000, 453721.3789000000106171 6702164.1966000003740191 0.0000000000000000, 453681.9722000000183471 6702132.7240000003948808 0.0000000000000000, 453650.0884000000078231 6702108.3876000000163913 0.0000000000000000, 453614.8120999999810010 6702079.4940999997779727 0.0000000000000000, 453581.6897999999928288 6702053.2345000002533197 0.0000000000000000, 453554.9898999999859370 6702024.1650000000372529 0.0000000000000000, 453519.5375999999814667 6701999.7505999999120831 0.0000000000000000, 453478.0347000000183471 6701972.6952999997884035 0.0000000000000000, 453443.6049999999813735 6701951.0467999996617436 0.0000000000000000, 453400.0459000000264496 6701926.4113999996334314 0.0000000000000000, 453372.2803999999887310 6701907.8296999996528029 0.0000000000000000, 453334.5289999999804422 6701883.0614999998360872 0.0000000000000000, 453282.7420000000274740 6701892.8850999996066093 0.0000000000000000, 453214.3585999999777414 6701906.2022000001743436 0.0000000000000000, 453163.1503999999840744 6701916.6575999995693564 0.0000000000000000, 453156.6243000000249594 6701883.6019000001251698 0.0000000000000000)",
                "locationAccuracy": null,
                "mapper": "Test user",
                "mappingMethod": null,
                "measure": "9221",
                "owner": null,
                "plan": null,
                "remarks": "This is a test cable.",
                "rentPaid": null,
                "renter": null,
                "role": null,
                "secondaryLength": null,
                "startReading": null,
                "state": "3210",
                "supercable": null,
                "supercableOrderno": null,
                "surveyAmount": "",
                "telecomArea": null,
                "totalCapacity": null,
                "totalLength": null,
                "updatedBy": "user@keypro.fi",
                "updatedTs": "2020-02-19T12:41:35.995577",
                "usedCapacity": null
              }
            },
            "schema": {
              "$ref": "#/definitions/FlatCable"
            }
          },
          "400": {
            "description": "There was an error in request. Usually field validation failed.",
            "schema": {
              "additionalProperties": {
                "description": "List of validation errors for this fieldname",
                "items": {
                  "description": "Validation error",
                  "type": "string"
                },
                "type": "array"
              },
              "description": "Fields which failed validation",
              "minProperties": "1",
              "type": "object"
            }
          },
          "401": {
            "$ref": "#/responses/Http401"
          }
        },
        "security": [
          {
            "Token": []
          }
        ],
        "summary": "Create new cable",
        "tags": [
          "Cable"
        ]
      }
    }
  }
}
````