Skip to content

Append, trim, or close

POST
/{stream}

The request Content-Type selects the append mode. The batch media types carry multiple records with headers. Any other Content-Type appends the raw body as a single record. An empty body with SS-Closed closes the stream. An empty body with SS-Trim-Seq trims it.

Parameters

Header Parameters

Content-Type
Type
string
SS-Match-Seq

Append only if the tail equals this sequence number

Type
string
Pattern
"^(0|[1-9][0-9]*)$"
SS-Producer-Id
Type
string
SS-Producer-Epoch
Type
string
Pattern
"^(0|[1-9][0-9]*)$"
SS-Producer-Seq
Type
string
Pattern
"^(0|[1-9][0-9]*)$"
SS-Closed
Type
string
Valid values
"true"
SS-Trim-Seq
Type
string
Pattern
"^(0|[1-9][0-9]*)$"

Request Body

JSON
{
  
"records": [
  
  
{
  
  
  
"headers": {
  
  
  
  
"additionalProperties": "string"
  
  
  
},
  
  
  
"body": "string",
  
  
  
"body_b64": "string"
  
  
}
  
]
}

Responses

Appended

Playground

Headers
Body

Samples