Sign in
Space

Retrieve geographic permissions

Returns the countries the space has selected for international traffic, together with the countries it may select. The selection is read from the billing service, so the response is 502 when that service is unavailable.

Permissions

Authenticate with a Personal access token whose holder is an owner or admin of the space. A project API token is not accepted on this endpoint, and a Personal access token has no scopes: the holder's role in the space is the whole authorization decision.

get/api/space/geographic_permissions

Response

The request has succeeded.

type'geographic_permission' required

The object type. Always geographic_permission.

countriesstring[] required

The selected ISO 3166-1 alpha-2 country codes.

supported_countriesstring[] required

The ISO 3166-1 alpha-2 country codes that may be selected.

Example response

{
  "type": "geographic_permission",
  "countries": [
    "US",
    "CA"
  ],
  "supported_countries": [
    "US",
    "CA",
    "GB"
  ]
}

Changes

Changed in 1 of the 161 revisions of this API.1

Of the 161 revisions, 3 have a changelog that could not be searched.