Synadia Communications Subject Import API

The subject-import API from Synadia Communications — 1 operation(s) for subject-import.

Documentation GitHub OpenAPI

Operations 3

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

DELETE /core/beta/subject-imports/{subjectImportId} Delete a subject import · Delete Subject Import #

Ask an LLM

“Can I remove a subject import from my account?”

“How do I stop importing a subject?”

Tell an agent destructive · confirm first

Delete subject import {import}.

Remove subject import {import}.

GET /core/beta/subject-imports/{subjectImportId} Look up a subject import · Get Subject Import #

Ask an LLM

“How do I view the settings of one subject import?”

“What JWT settings does a given subject import use?”

Tell an agent

Show subject import {import}.

Get details for subject import {import}.

PATCH /core/beta/subject-imports/{subjectImportId} Update a subject import · Update Subject Import #

Ask an LLM

“How do I change the JWT settings of an existing subject import?”

“Can I edit a subject import after it's created?”

Tell an agent

Update subject import {import} with JWT settings {jwt_settings}.

Change subject import {import}'s settings to {jwt_settings}.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/synadia-communications:synadia-communications-subject-import-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  description: API for Synadia Control Plane / Synadia Cloud
  title: Synadia Control Plane / Synadia Cloud Subject Import API
  version: beta
servers:
- description: Path to Synadia Control Plane Server Api
  url: '{baseUrl}/api'
  variables:
    baseUrl:
      default: ''
security:
- bearerAuth: []
  sessionAuth: []
tags:
- name: subject-import
paths:
  /core/beta/subject-imports/{subjectImportId}:
    delete:
      operationId: deleteSubjectImport
      parameters:
      - explode: false
        in: path
        name: subjectImportId
        required: true
        schema:
          type: string
        style: simple
      responses:
        '204':
          description: No Content
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      summary: Delete Subject Import
      tags:
      - subject-import
      x-doc-tags:
      - Sharing
    get:
      description: Returns Subject Import
      operationId: getSubjectImport
      parameters:
      - explode: false
        in: path
        name: subjectImportId
        required: true
        schema:
          type: string
        style: simple
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubjectImportViewResponse'
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      summary: Get Subject Import
      tags:
      - subject-import
      x-doc-tags:
      - Sharing
    patch:
      description: Updates Subject Import
      operationId: updateSubjectImport
      parameters:
      - explode: false
        in: path
        name: subjectImportId
        required: true
        schema:
          type: string
        style: simple
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SubjectImportUpdateRequest'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubjectImportViewResponse'
          description: Success
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
      summary: Update Subject Import
      tags:
      - subject-import
      x-doc-tags:
      - Sharing
components:
  schemas:
    Import:
      description: Import describes a mapping from another account into this one
      example:
        local_subject: local_subject
        subject: subject
        name: name
        share: true
        to: to
        type: null
        account: account
        token: token
      properties:
        account:
          type: string
        local_subject:
          description: 'Local subject used to subscribe (for streams) and publish (for services) to.

            This value only needs setting if you want to change the value of Subject.

            If the value of Subject ends in > then LocalSubject needs to end in > as well.

            LocalSubject can contain $<number> wildcard references where number references the nth wildcard in Subject.

            The sum of wildcard reference and * tokens needs to match the number of * token in Subject.'
          type: string
        name:
          type: string
        share:
          type: boolean
        subject:
          description: 'Subject field in an import is always from the perspective of the

            initial publisher - in the case of a stream it is the account owning

            the stream (the exporter), and in the case of a service it is the

            account making the request (the importer).'
          type: string
        to:
          description: 'Deprecated: use LocalSubject instead

            To field in an import is always from the perspective of the subscriber

            in the case of a stream it is the client of the stream (the importer),

            from the perspective of a service, it is the subscription waiting for

            requests (the exporter). If the field is empty, it will default to the

            value in the Subject field.'
          type: string
        token:
          type: string
        type:
          $ref: '#/components/schemas/ExportType'
      type: object
    ExportType:
      description: ExportType defines the type of import/export.
      enum:
      - stream
      - service
      type: string
    ImportPatch:
      example:
        local_subject: local_subject
        subject: subject
        name: name
        share: true
        to: to
        type: null
        account: account
        token: token
      properties:
        account:
          type: string
        local_subject:
          type:
          - string
          - 'null'
        name:
          type: string
        share:
          type: boolean
        subject:
          type: string
        to:
          type:
          - string
          - 'null'
        token:
          type:
          - string
          - 'null'
        type:
          $ref: '#/components/schemas/ExportType'
      type: object
    SubjectImportUpdateRequest:
      example:
        jwt_settings:
          local_subject: local_subject
          subject: subject
          name: name
          share: true
          to: to
          type: null
          account: account
          token: token
      properties:
        jwt_settings:
          $ref: '#/components/schemas/ImportPatch'
      type: object
    SubjectImportViewResponse:
      description: '/

        Subject Imports

        /'
      example:
        remote_account_nkey_public: remote_account_nkey_public
        remote_subject: remote_subject
        created: 2000-01-23 04:56:07+00:00
        jwt_settings:
          local_subject: local_subject
          subject: subject
          name: name
          share: true
          to: to
          type: null
          account: account
          token: token
        name: name
        id: id
      properties:
        created:
          format: date-time
          type: string
        id:
          type: string
        jwt_settings:
          $ref: '#/components/schemas/Import'
        name:
          type: string
        remote_account_nkey_public:
          type: string
        remote_subject:
          type: string
      required:
      - created
      - id
      - jwt_settings
      - name
      - remote_account_nkey_public
      - remote_subject
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: Personal Access Token
      scheme: bearer
      type: http
    sessionAuth:
      in: cookie
      name: control_plane_session
      type: apiKey

Synadia Communications Subject Import API

Operations 3

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification