Update geographic permissions

PUT

https://{your_space_name}.signalwire.com/api/space/geographic_permissions

Replaces the selected countries with the array in the request. Codes outside supported_countries are dropped; if nothing supported remains, the request is rejected with no_supported_countries.

Updating the selection additionally requires that the space is allowed to edit international settings. A space that is not receives 401 even when the token holder is an owner or admin.

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.

Replaces the selected countries with the array in the request. Codes outside `supported_countries` are dropped; if nothing supported remains, the request is rejected with `no_supported_countries`. Updating the selection additionally requires that the space is allowed to edit international settings. A space that is not receives `401` even when the token holder is an owner or admin. #### Permissions Authenticate with a [Personal access token](/docs/apis/authorization#personal-access-tokens) 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.

Authentication

AuthorizationBasic

Personal access token authentication for space-wide administration.

Send HTTP Basic auth with an empty username and the Personal access token as the password. A Personal access token carries your own authority rather than a project’s: it is created from your user menu in the Dashboard, is prefixed pat_, and has no scopes. The holder must be an owner or admin of the space named by the subdomain, and the token acts only on that space.

Example:

Authorization: Basic base64(:pat_...)

Personal access token authentication for space-wide administration. Send HTTP Basic auth with an empty username and the Personal access token as the password. A Personal access token carries your own authority rather than a project's: it is created from your user menu in the Dashboard, is prefixed `pat_`, and has no scopes. The holder must be an owner or admin of the space named by the subdomain, and the token acts only on that space. Example: ``` Authorization: Basic base64(:pat_...) ```

Request

This endpoint expects an object.

countrieslist of stringsRequired

The ISO 3166-1 alpha-2 country codes to select. The array replaces the current selection. Codes outside supported_countries are dropped, and if nothing supported remains the request is rejected with no_supported_countries.

Response

The request has succeeded.

typeenum

The object type. Always geographic_permission.

countrieslist of strings

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

supported_countrieslist of strings

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

Errors

400

Bad Request Error

401

Unauthorized Error

422

Unprocessable Entity Error

500

Internal Server Error

502

Bad Gateway Error