Skip to navigation

Update geographic permissions

View as MarkdownOpen in Claude

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.

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_...)

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.

Allowed values:
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