Streams

Create a new stream

Changed on Jul 4, 2025

Creates a new stream for message publishing

post/storage/streams

Request

Base URL
https://api.quiva.ai
Auth
- HTTP bearer
- or API key in header x-api-key
TypeScript
https://skmtc.dev/quivaworks/apis/quiva-ai-gateway-5/docs/storage/streams/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

namestring required

Name of the stream to create

descriptionstring

Description of the stream

subjectsstring[]

Subject patterns to capture

max_consumersinteger

Maximum number of consumers

max_msgsinteger

Maximum number of messages

max_bytesinteger

Maximum size in bytes

discard0 | 1

Discard policy (0 = old, 1 = new)

max_msgs_per_subjectinteger

Maximum messages per subject

max_msg_sizeinteger

Maximum message size in bytes

storage'file' | 'memory'

num_replicasinteger

Number of replicas

sealedboolean

Whether the stream is sealed

deny_deleteboolean

Whether deletes are denied

deny_purgeboolean

Whether purges are denied

Response

Bad Request

messagestring

Example response

{
  "message": "success"
}

Changes

Jul 4, 2025ad8205bf93a3 Revision changes
- breaking
  removed the enum value 0.00 of the request property
- breaking
  removed the enum value 1.00 of the request property
- breaking
  the request property type changed from integer to string
- info
  the request property default value 0 was removed
- info
  added the new file enum value to the request property
- info
  added the new memory enum value to the request property
Jul 4, 2025d566a61279be Revision changes
- breaking
  added the new required request property
- breaking
  the request's body type changed from no type to object
- warning
  removed from the request body allOf list
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the new optional request property
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  removed the Success enum value from the response property for the response status

Operation history (3 revisions)