PATCH
/
v1
/
consumers
/
postgres
/
{id}
curl --request POST \
  --url https://api.sequin.io/v1/consumers/http \
  --header 'Authorization: Bearer YOUR_API_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "consume-stripe-collections",
    "active": true,
    "syncs": ["446e3f05-6021-48f5-8c28-ec7e1fa9e944"], // or ["*"] for all syncs
    "metadata": { "custom_property": 42 },
  }'
{
    "id": "00000582-47fb-422e-8a79-da12502ccc63",
    "name": "consume-stripe-collections",
    "active": true,
    "syncs": ["446e3f05-6021-48f5-8c28-ec7e1fa9e944"], // or ["*"] for all syncs
    "target_id": "6c4ecaaa-b62a-4cf8-aa99-8f00e2ec3d1a",
    "health": {
      "status": "ok",
      "notes": [],
      "time": "2023-12-15 01:29:29"
    },
    "metadata": { "custom_property": 42 },
    "created_at": "2023-12-15 01:29:29",
    "updated_at": "2023-12-15 01:29:29"
  }

Request parameters

name
string

Name of the Postgres consumer.

active
boolean

Whether the consumer is active or not.

syncs
array

Array of the sync ids that are connected to this consumer. ["*"] indicates that every sync is connected to this consumer.

mappings
array

Array of the mappings for the Postgres consumer. See the Postgres consumer mappings object.

metadata
string

Metadata for the consumer. This is a free-form object that you can use to store any additional information you want to associate with the consumer.

Response fields

id
string

ID of the Postgres consumer.

name
string

Name of the Postgres consumer.

active
boolean

Whether the consumer is active or not.

syncs
array

Array of the sync ids that are connected to this consumer. ["*"] indicates that every sync is connected to this consumer.

target_id
string

ID of the target.

health
object

Health status of the consumer. Learn more about the health object.

metadata
string

Metadata for the consumer. This is a free-form object that you can use to store any additional information you want to associate with the consumer.

created_at
string

Timestamp of when the consumer was created, in ISO 8601 format.

updated_at
string

Timestamp of when the consumer was last updated, in ISO 8601 format.