Skip to content

Gets realtime configuration

get/v1/projects/{ref}/config/realtime

The fine-grained token must include the following permissions to access this endpoint:

  • realtime_config_read

Path parameters

  • ref
    Required
    string

    Project ref

Response codes

  • 200
  • 401
  • 403
  • 429

Response (200)

{
"private_only": true,
"connection_pool": 1,
"postgres_changes_pool": 1,
"max_concurrent_users": 1,
"max_events_per_second": 1,
"max_bytes_per_second": 1,
"max_channels_per_client": 1,
"max_joins_per_second": 1,
"max_presence_events_per_second": 1,
"max_payload_size_in_kb": 1,
"suspend": true,
"presence_enabled": true,
"admin_suspended_at": "4404-02-29T04:24Z"
}
{
"type": "object",
"properties": {
"private_only": {
"type": "boolean",
"description": "Whether to only allow private channels",
"nullable": true
},
"connection_pool": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Sets connection pool size for Realtime Authorization",
"nullable": true
},
"postgres_changes_pool": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Sets connection pool size used to create Postgres Changes subscriptions",
"nullable": true
},
"max_concurrent_users": {
"type": "integer",
"minimum": 1,
"maximum": 300000,
"description": "Sets maximum number of concurrent users rate limit",
"nullable": true
},
"max_events_per_second": {
"type": "integer",
"minimum": 1,
"maximum": 50000,
"description": "Sets maximum number of events per second rate per channel limit",
"nullable": true
},
"max_bytes_per_second": {
"type": "integer",
"minimum": 1,
"maximum": 10000000,
"description": "Sets maximum number of bytes per second rate per channel limit",
"nullable": true
},
"max_channels_per_client": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"description": "Sets maximum number of channels per client rate limit",
"nullable": true
},
"max_joins_per_second": {
"type": "integer",
"minimum": 1,
"maximum": 5000,
"description": "Sets maximum number of joins per second rate limit",
"nullable": true
},
"max_presence_events_per_second": {
"type": "integer",
"minimum": 1,
"maximum": 5000,
"description": "Sets maximum number of presence events per second rate limit",
"nullable": true
},
"max_payload_size_in_kb": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"description": "Sets maximum number of payload size in KB rate limit",
"nullable": true
},
"suspend": {
"type": "boolean",
"description": "Disables the Realtime service for this project when true. Set to false to re-enable it.",
"nullable": true
},
"presence_enabled": {
"type": "boolean",
"description": "Whether to enable presence"
},
"admin_suspended_at": {
"type": "string",
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
"description": "If set, the Realtime service has been suspended by an admin.",
"nullable": true
}
},
"required": [
"private_only",
"connection_pool",
"postgres_changes_pool",
"max_concurrent_users",
"max_events_per_second",
"max_bytes_per_second",
"max_channels_per_client",
"max_joins_per_second",
"max_presence_events_per_second",
"max_payload_size_in_kb",
"suspend",
"presence_enabled",
"admin_suspended_at"
]
}