Log in Sign up
APIsCloudDelete organization API tokenUpdate organization API tokenRegenerate organization API token secretList organization API tokensCreate API token for organizationDelete address list entryGet address list entryUpdate address list entryList global address listsDelete address listGet address listUpdate address listList address list entriesCreate address list entryBulk change address list entriesList address listsCreate address listDelete certificateGet certificateRe-issue certificateReset certificate API tokenList certificatesCreate certificateDelete a container registry artifactGet container registry artifact detailsList container registry regionsDelete container registry repositoryList container registry artifactsList container registry repositoriesList countriesGet countryList country statesGet country stateList currenciesGet currencyDelete DNS recordGet DNS recordUpdate DNS recordDelete DNS zoneGet DNS zoneUpdate DNS zoneList DNS recordsCreate DNS recordVerify DNS zoneList DNS zonesCreate DNS zoneList nameserversList data centersGet data centerGet default network of data centerList disk IO profilesDelete disk backup policyGet disk backup policyUpdate a disk backup policySchedule delete disk backup policyList disk backup policies for diskCreate disk backup policy for diskList disk backup policiesCreate disk backup policy for organizationList disk backup policies for virtual machineCreate disk backup policy for Virtual MachineGet disk template versionGet disk template version specList disk template versionsGet disk templateList disk templatesDelete diskGet diskUpdate diskAssign disk to virtual machineAttach disk to virtual machineDetach disk from virtual machineChange disk IO profileResize diskUnassign disk from virtual machineList disksCreate diskList virtual machine disksDelete file storage volumeGet file storage volumeUpdate file storage volumeList file storage volumesCreate file storage volumeList GPU types for Data CenterList GPU typesGet GPU typeRelease an IP addressGet IP addressUpdate IP addressUnallocate an IP addressList IP addressesCreate IP AddressDelete load balancerGet load balancerUpdate load balancerList load balancer rulesCreate load balancer ruleDelete load balancer ruleGet load balancer ruleUpdate load balancer ruleList load balancersCreate load balancerList network speed profilesGet NetworkList networksDelete object storage access keyGet object storage access key detailsUpdate object storage access keyGenerate object storage S3 access key credentialsDelete object storage bucketGet an object storage bucketUpdate object storage bucketGet an object storage objectCreate a presigned url for an object storage objectRevoke object storage bucket presigned URLsList object storage access keysMove object storage to trashGet object storage account detailsCreate object storage accountCreate object storage access keyCreate object storage bucketList operating systemsGet operating systemDelete managed organizationUpdate managed organizationsList organizationsGet organizationDeletion stepsList managed organizationsCreate managed organizationGet organization limits and usageGet organization policy limitsGet organization pricesList organization usersList organization SSH keysAdd organization SSH keyDelete SSH keyList security groupsCreate security groupDelete security group ruleGet security group ruleUpdate security group ruleDelete security groupGet security groupUpdate security groupList security group rulesCreate security group ruleList tagsCreate a tagDelete a tagGet tagUpdate a tagGet TaskList trash objectsPurge all trash objectsPurge a trash objectGet trash objectRestore a trash objectGet current user detailsList virtual networksCreate a virtual networkDelete a virtual networkGet virtual networkUpdate a virtual networkList virtual machine groupsCreate a virtual machine groupDelete a virtual machine groupGet virtual machine groupUpdate a virtual machine groupDelete a virtual machine network interfaceGet virtual machine network interfaceAllocate an IP addressAllocate a new IP addressAttach to virtual machineGet addresses available for network interfaceDetach from virtual machineUpdate the network speed profile for a virtual machine network interfaceList virtual machine network interfacesCreate a virtual network interfaceGet virtual machine network interface by networkList virtual machine packagesGet virtual machine packageList virtual machinesBuild virtual machineBuild virtual machine (from spec)Get authorized keys for a virtual machineGet virtual machine buildDelete virtual machineGet virtual machineUpdate a Virtual MachineAllocate an IP AddressCreate console sessionChange flexible resourcesChange packageReset virtual machineShutdown virtual machineStart virtual machineStop virtual machineList zonesGet zone
Get organization limits and usage APIs Cloud Get organization limits and usage Search docs / Returns the computed policy limits for a organization
GET https://api.katapult.io/core/v1/organizations/organization/policy
Details Success status 200 OK Required scopes organizations:read

Possible errors

Code Error When it happens
400 missing_api_token No API token was provided in the Authorization header. Ensure a token is provided prefixed with Bearer
400 policy_not_available_for_managed_organizations Managed organizations do not have policies. Make this request on the parent organization instead.
403 unauthorized_network_for_api_token Network is not allowed to access the API with this API token
403 invalid_api_token The API token provided was not valid (it may not exist or have expired)
403 token_owner_suspended The user that owns the API token has been suspended
403 invalid_capabilities_token The capabilities token provided was not valid (either not valid, expired or not signed by the correct key)
403 scope_not_granted The scope required for this endpoint has not been granted to the authenticating identity
403 organization_suspended An organization was found from the arguments provided but it was suspended
403 organization_not_activated An organization was found from the arguments provided but it wasn't activated yet
404 organization_not_found No organization was found matching any of the criteria provided in the arguments
429 rate_limit_reached You have reached the rate limit for this type of request
503 service_unavailable The service is currently unavailable, please try again later
Arguments
  • organization[id] string query

    All 'organization[]' params are mutually exclusive, only one can be provided.

  • organization[sub_domain] string query

    All 'organization[]' params are mutually exclusive, only one can be provided.

 Response
  • policy_type string

    Allowed values: autooverridenone

  • policy_name string
  • limits object
    • uninvoiced_balance object
      • limit number
      • current number
      • currency object
        • id string
        • name string
        • iso_code string
        • symbol string
    • credit_balance object
      • limit number
      • current number
      • currency object
        • id string
        • name string
        • iso_code string
        • symbol string
    • debt_on_resource_creation object
      • limit number
      • current number
      • currency object
        • id string
        • name string
        • iso_code string
        • symbol string
    • virtual_machines object
      • limit integer
      • current integer
      • unit string
    • virtual_machine_memory object
      • limit integer
      • current integer
      • unit string
    • managed_organizations object
      • limit integer
      • current integer
      • unit string
    • unallocated_ip_addresses object
      • limit integer
      • current integer
      • unit string
    • disk_space object
      • limit integer
      • current integer
      • unit string
    • security_groups object
      • limit integer
      • current integer
      • unit string
    • virtual_networks object
      • limit integer
      • current integer
      • unit string
    • load_balancers object
      • limit integer
      • current integer
      • unit string
    • dns_zones object
      • limit integer
      • current integer
      • unit string
    • certificates object
      • limit integer
      • current integer
      • unit string
    • file_storage_volumes object
      • limit integer
      • current integer
      • unit string
    • isos object
      • limit integer
      • current integer
      • unit string
    • disk_iops object
      • limit integer
      • unit string
    • network_speed object
      • limit integer
      • unit string
    • maximum_container_registry_space object
      • limit integer
      • current integer
      • unit string
  • features object
    • disk_bus_configuration object
      • permitted boolean
    • zone_selection object
      • permitted boolean
    • restricted_traffic_types object
      • permitted boolean
    • suspension object
      • permitted boolean
    • flexible_virtual_machine_resources object
      • permitted boolean
  • reasons_for_disallowing_resource_creation array

Example response

{
  "policy_type": "auto",
  "policy_name": "string",
  "limits": {
    "uninvoiced_balance": {
      "limit": 0,
      "current": 0,
      "currency": {
        "id": "string",
        "name": "string",
        "iso_code": "string",
        "symbol": "string"
      }
    },
    "credit_balance": {
      "limit": 0,
      "current": 0,
      "currency": {
        "id": "string",
        "name": "string",
        "iso_code": "string",
        "symbol": "string"
      }
    },
    "debt_on_resource_creation": {
      "limit": 0,
      "current": 0,
      "currency": {
        "id": "string",
        "name": "string",
        "iso_code": "string",
        "symbol": "string"
      }
    },
    "virtual_machines": {
      "limit": 0,
      "current": 0,
      "unit": "string"
    },
    "virtual_machine_memory": {
      "limit": 0,
      "current": 0,
      "unit": "string"
    },
    "managed_organizations": {
      "limit": 0,
      "current": 0,
      "unit": "string"
    },
    "unallocated_ip_addresses": {
      "limit": 0,
      "current": 0,
      "unit": "string"
    },
    "disk_space": {
      "limit": 0,
      "current": 0,
      "unit": "string"
    },
    "security_groups": {
      "limit": 0,
      "current": 0,
      "unit": "string"
    },
    "virtual_networks": {
      "limit": 0,
      "current": 0,
      "unit": "string"
    },
    "load_balancers": {
      "limit": 0,
      "current": 0,
      "unit": "string"
    },
    "dns_zones": {
      "limit": 0,
      "current": 0,
      "unit": "string"
    },
    "certificates": {
      "limit": 0,
      "current": 0,
      "unit": "string"
    },
    "file_storage_volumes": {
      "limit": 0,
      "current": 0,
      "unit": "string"
    },
    "isos": {
      "limit": 0,
      "current": 0,
      "unit": "string"
    },
    "disk_iops": {
      "limit": 0,
      "unit": "string"
    },
    "network_speed": {
      "limit": 0,
      "unit": "string"
    },
    "maximum_container_registry_space": {
      "limit": 0,
      "current": 0,
      "unit": "string"
    }
  },
  "features": {
    "disk_bus_configuration": {
      "permitted": true
    },
    "zone_selection": {
      "permitted": true
    },
    "restricted_traffic_types": {
      "permitted": true
    },
    "suspension": {
      "permitted": true
    },
    "flexible_virtual_machine_resources": {
      "permitted": true
    }
  },
  "reasons_for_disallowing_resource_creation": []
}
 Try it
Requests are real Executing sends a live GET request to https://api.katapult.io/core/v1 from your browser. There is no sandbox — the call hits whichever environment your token belongs to, and any change it makes is a real change.
Token

Sent to https://api.katapult.io/core/v1 as a bearer token and never to Krystal Documentation. It isn't stored anywhere, so paste it again on each endpoint page.

API token
Query parameters

Left blank, a parameter is omitted from the request.

All 'organization[]' params are mutually exclusive, only one can be provided. organization[id] All 'organization[]' params are mutually exclusive, only one can be provided. organization[sub_domain]
Execute Copy as curl
Navigate Select Esc to close