POST
/
v2
/
kafka
/
update-topic
/
{id}
curl -X POST \
  https://api.upstash.com/v2/kafka/update-topic/:id \
  -u 'EMAIL:API_KEY' \
  -d '{"retention_time":1235,"retention_size":4568,"max_message_size":8913}'

{
    "topic_id": "0f458c88-2dc6-4f69-97bb-05060e0be934",
    "topic_name": "test-kafka-topic",
    "cluster_id": "9bc0e897-cbd3-4997-895a-fd77ad00aec9",
    "region": "eu-west-1",
    "creation_time": 1643981720,
    "state": "active",
    "partitions": 1,
    "multizone": true,
    "tcp_endpoint": "sharing-mastodon-12819-eu1-kafka.upstashdev.com",
    "rest_endpoint": "sharing-mastodon-12819-eu1-rest-kafka.upstashdev.com",
    "username": "c2hhcmluZy1tYXN0b2Rvbi0xMjgxOSRV1ipriSBOwd0PHzw2KAs_cDrTXzvUKIs",
    "password": "eu8K3rYRS-ma0AsINDo7MMemmHjjRSldHJcG3c1LUMZkFfdSf9u_Kd4xCWO9_oQc",
    "cleanup_policy": "delete",
    "retention_size": 4568,
    "retention_time": 1235,
    "max_message_size": 8913
}

​
URL Parameters

​
id
string
required
The unique ID of the topic

​
Request Parameters

​
retention_time
int
Retention time of messsages in the topic\ -1 for highest possible value
​
retention_size
int
Retention size of the messages in the topic\ -1 for highest possible value
​
max_message_size
int
Max message size in the topic\

​
Response Parameters

​
topic_id
string
ID of the new kafka topic
​
topic_name
string
Name of the new kafka topic
​
cluster_id
string
ID of the created Kafka cluster
​
region
string
The region the Kafka cluster is deployed in
​
creation_time
int
Cluster creation timestamp
​
state
string
State of the topic\ active or deleted
​
partitions
int
Number of partitions the topic has
​
multizone
boolean
Whether the multizone replication is enabled for the cluster or not
​
tcp_endpoint
string
TCP endpoint to connect to the Kafka cluster
​
rest_endpoint
string
REST endpoint to connect to the Kafka cluster
​
username
string
Cleanup policy to be used in the topic\ compact or delete
​
password
string
Password to be used in authenticating to the cluster
​
cleanup_policy
string
Max total number of partitions allowed in the cluster
​
max_retention_size
int
Max retention size will be allowed to topics in the cluster
​
max_retention_time
int
Max retention time will be allowed to topics in the cluster
​
max_message_size
int
Max message size will be allowed in topics in the cluster
curl -X POST \
  https://api.upstash.com/v2/kafka/update-topic/:id \
  -u 'EMAIL:API_KEY' \
  -d '{"retention_time":1235,"retention_size":4568,"max_message_size":8913}'

{
    "topic_id": "0f458c88-2dc6-4f69-97bb-05060e0be934",
    "topic_name": "test-kafka-topic",
    "cluster_id": "9bc0e897-cbd3-4997-895a-fd77ad00aec9",
    "region": "eu-west-1",
    "creation_time": 1643981720,
    "state": "active",
    "partitions": 1,
    "multizone": true,
    "tcp_endpoint": "sharing-mastodon-12819-eu1-kafka.upstashdev.com",
    "rest_endpoint": "sharing-mastodon-12819-eu1-rest-kafka.upstashdev.com",
    "username": "c2hhcmluZy1tYXN0b2Rvbi0xMjgxOSRV1ipriSBOwd0PHzw2KAs_cDrTXzvUKIs",
    "password": "eu8K3rYRS-ma0AsINDo7MMemmHjjRSldHJcG3c1LUMZkFfdSf9u_Kd4xCWO9_oQc",
    "cleanup_policy": "delete",
    "retention_size": 4568,
    "retention_time": 1235,
    "max_message_size": 8913
}