Ingests

Update an ingest by ID

patch/ingests/{id}

Path parameters

idstring required

Ingest ID

Ingest ID

Request body

namestring

Name of the ingest

type'rtmp-push' | 'rtmp-pull' | 'srt-pull' | 'srt-push' | 'sdi-pull' | 'rtsp-pull' | 'ndi-pull'

Ingest type. Note: srt-push requires SRT push to be enabled at organization level

urlstring

Source URL

regionstring

Region ID (required for rtmp-push, srt-pull and rtmp-pull). Must be a single ingest enabled region for pull types. Required and must be a DUPLO region when a 'speech' enhancement is enabled. Required and must be an on-prem region for rtsp-pull, ndi-pull and sdi-pull (ndi-pull and sdi-pull additionally require the region to support the ingest type)

Response

Updated ingest

Changes

Changed in 5 of the 9 revisions of this API.21211

  • 3dc30dd236242115See the full diff
    • added IngestSdi subschema #2 to the sdi request property allOf list

      request-property-all-of-added

    • the sdi request property type/format changed from object/ to /

      request-property-type-changed

    • removed the request property enhancements

      request-property-removed

    • removed the request property sdi/audioConnection

      request-property-removed

    • removed the request property sdi/deviceNumber

      request-property-removed

    • removed the request property sdi/persistentId

      request-property-removed

    • removed the request property sdi/profile

      request-property-removed

    • removed the request property sdi/videoConnection

      request-property-removed

    • removed the request property sdi/videoFormat

      request-property-removed

    • removed the request property sdi/videoMode

      request-property-removed

    • removed the optional property data/allOf[Ingest]/enhancements from the response with the 200 status

      response-optional-property-removed

    • added the new ndi-pull enum value to the data/allOf[Ingest]/type response property for the response status 200

      response-property-enum-value-added

    • added the new rtsp-pull enum value to the data/allOf[Ingest]/type response property for the response status 200

      response-property-enum-value-added

    • added the new optional request property ndi

      new-optional-request-property

    • added the new ndi-pull enum value to the request property type

      request-property-enum-value-added

    • added the new rtsp-pull enum value to the request property type

      request-property-enum-value-added

    • added the optional property data/allOf[Ingest]/ndi to the response with the 200 status

      response-optional-property-added

    • added the optional property data/allOf[Ingest]/sdi to the response with the 200 status

      response-optional-property-added

    This revision also has 9 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • the enhancements/items/oneOf[SpeechEnhancement]/position/bottom request property's max was set to 90.00

      request-property-max-set

    • added the new optional request property enhancements/items/oneOf[SpeechEnhancement]/extraPrompt

      new-optional-request-property

    • added the optional property data/allOf[Ingest]/enhancements/items/oneOf[SpeechEnhancement]/extraPrompt to the response with the 200 status

      response-optional-property-added

    • added the new optional request property enhancements/items/oneOf[SpeechEnhancement]/latencyMode

      new-optional-request-property

    • added the optional property data/allOf[Ingest]/enhancements/items/oneOf[SpeechEnhancement]/latencyMode to the response with the 200 status

      response-optional-property-added

    • added the new optional request property enhancements

      new-optional-request-property

    • added the optional property data/allOf[Ingest]/enhancements to the response with the 200 status

      response-optional-property-added