Send a batch of topics to a destination (idempotent)

Attach every topic in the body to this destination’s managed binding in one write.

Topics already on the binding are no-ops, so a retry of the whole set is safe.

POST/destinations/{destination_id}/topics

Authorization

AuthorizationBearer token · headerrequired

Path parameters

destination_idstringrequired

Request body

requiredapplication/json

topic_idsstring[]required

Full topic ids, all belonging to one source.

min items 1

Responses

200

Successful Response

binding_idstringrequired

source_idstringrequired

destination_idstringrequired

destination_namestringrequired

destination_connectorstringrequired

topic_idsstring[]required

managedboolean

default: true

422

Validation Error

detailValidationError[]

Show properties

Array of ValidationError

locstring | integer[]required

Show properties

Array of string | integer

Any of:

string

string

integer

integer

msgstringrequired

typestringrequired

inputany

ctxobject

Request

curl -X POST 'https://api.streamkap.com/destinations/string/topics' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "topic_ids": [
    "string"
  ]
}'

const response = await fetch("https://api.streamkap.com/destinations/string/topics", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"topic_ids\": [\n    \"string\"\n  ]\n}"
});

import requests

response = requests.post(
    "https://api.streamkap.com/destinations/string/topics",
    headers={
        "Authorization": "Bearer YOUR_TOKEN",
        "Content-Type": "application/json"
    },
    data="{\n  \"topic_ids\": [\n    \"string\"\n  ]\n}",
)

Response

{
  "binding_id": "string",
  "source_id": "string",
  "destination_id": "string",
  "destination_name": "string",
  "destination_connector": "string",
  "topic_ids": [
    "string"
  ],
  "managed": true
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}