Sign in
Ingest Endpoint

Upsert Ingest Endpoint

Create or update an ingest endpoint.

put/ingest/api/v1/source/{source_id}/endpoint/{endpoint_id}

Path parameters

source_idstring required

The Source's ID or UID.

Example:unique-identifier

The Source's ID or UID.

endpoint_idstring required

The Endpoint's ID or UID.

Example:unique-identifier

The Endpoint's ID or UID.

Request body

descriptionstring
disabledboolean
metadataobject
throttleRateinteger nullable

Maximum messages per second to send to this endpoint.

Outgoing messages will be throttled to this rate.

uidstring nullable

Optional unique identifier for the endpoint.

urlstring uri required

Example request

{
  "description": "An example endpoint name",
  "uid": "unique-identifier",
  "url": "https://example.com/webhook/"
}

Response

createdAtstring date-time required
descriptionstring required
disabledboolean
idstring required

The Endpoint's ID.

metadataobject required
throttleRateinteger nullable

Maximum messages per second to send to this endpoint.

Outgoing messages will be throttled to this rate.

uidstring nullable

Optional unique identifier for the endpoint.

updatedAtstring date-time required
urlstring uri required

Example response

{
  "id": "ep_1srOrx2ZWZBpBUvZwXKQmoEYga2",
  "uid": "unique-identifier",
  "url": "https://example.com/webhook/"
}

Changes

Changed in 1 of the 5 revisions of this API.21

  • dc130bd1b07421See the full diff
    • ●

      removed the request property rateLimit

      request-property-removed

    • ●

      removed the optional property rateLimit from the response with the 200 status

      response-optional-property-removed

    • ○

      api operation id v1.ingest.endpoint.update removed and replaced with v1.ingest.endpoint.upsert

      api-operation-id-removed

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