v17

latestOpenAPI 3.0.1raw.githubusercontent.com2026-07-08165682.0 MB
Database Postgres IP restrictions

Create an IP restriction entry

Authorization

A service token or OAuth token must have at least one of the following access or scopes in order to use this API endpoint:

Service Token Accesses write_database

OAuth Scopes

ResourceScopes
Organizationwrite_databases
Databasewrite_database
post/organizations/{organization}/databases/{database}/cidrs

Path parameters

organizationstring required

The name of the organization the database belongs to

databasestring required

The name of the database

Request body

schemastring

The PostgreSQL schema to restrict access to. Leave empty or omit to allow access to all schemas.

rolestring

The PostgreSQL role to restrict access to. Leave empty or omit to allow access for all roles.

cidrsstring[] required

List of IPv4 CIDR ranges (e.g., ['192.168.1.0/24', '192.168.1.1/32']). Must contain at least one valid IPv4 address or range.

Response

Returns the created IP restriction entry

idstring required

The ID of the IP allowlist entry

schemastring required

The schema name to restrict access to (optional)

rolestring required

The role to restrict access to (optional)

cidrsstring[] required

List of CIDR ranges

created_atstring required

When the entry was created

updated_atstring required

When the entry was updated

deleted_atstring nullable required

When the entry was deleted