--- name: svix description: Svix is a webhook delivery service that enables developers to send, receive, and manage webhooks with guaranteed delivery, retries, security (HMAC signing), and performance metrics, simplifying reliable event-driven integrations. Read and write Svix data through One: stream, streameventtype, application, ingestsource, connector, eventtype and more, 127 actions with real parameter documentation. Use whenever the user asks to look something up in Svix, create or update a record there, or build code against the Svix API. license: One-Knowledge-1.0 (https://www.withone.ai/licenses/knowledge) metadata: author: one-systems attribution: Integration knowledge by One (withone.ai) platform: svix generated-from: one-knowledge-base --- # Svix through One Svix is a webhook delivery service that enables developers to send, receive, and manage webhooks with guaranteed delivery, retries, security (HMAC signing), and performance metrics, simplifying reliable event-driven integrations. One exposes Svix through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters. ## How to run an action 1. Find the action in the table below, or call `search_one_platform_actions` with platform `svix` if it is not listed. 2. Call `get_one_action_knowledge` with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters. 3. Call `execute_one_action` with parameters copied from that knowledge. Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing. ## Before you start Call `list_one_integrations` once and confirm Svix is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP. Each connection carries an `access` field. If it reports `{"policy": "methods", "methods": ["GET"]}` the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused. ## Before a write Creates, updates, deletes and sends land on a real Svix account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation. ## Actions ### Stream | Action | Method | Path | Action id | |---|---|---|---| | Get a Stream | GET | `/api/v1/stream/{{stream_id}}` | `conn_mod_def::GJkDiA8_0Ug::v2aLs0D2Rl6zC6vmSpI3cQ` | | Create Stream | POST | `/api/v1/stream` | `conn_mod_def::GJkDh6jUu1g::8eNp6NTcS8-uxP4_BQs_yg` | | Delete a Stream | DELETE | `/api/v1/stream/{{stream_id}}` | `conn_mod_def::GJkDiTP22Hg::IYqfyLeHRWutfc0tX2nFow` | | Partially Update a Stream | PATCH | `/api/v1/stream/{{stream_id}}` | `conn_mod_def::GJkDiN90KAA::g8uYzNw0Tl-fPd6KV5TgEg` | | Update a Stream | PUT | `/api/v1/stream/{{stream_id}}` | `conn_mod_def::GJkDiIOJ-XA::v2U6JVjUR4mThV5ttILQGA` | ### StreamEventType | Action | Method | Path | Action id | |---|---|---|---| | Get a Stream Event Type | GET | `/api/v1/stream/event-type/{{name}}` | `conn_mod_def::GJkDjQv-POA::ydDrMOkgS2apgHKsCQsGMw` | | Create Stream Event Type | POST | `/api/v1/stream/event-type` | `conn_mod_def::GJkDjI9cQzA::rY9zCSTKRE6VviUANvNFDw` | | Delete a Stream Event Type | DELETE | `/api/v1/stream/event-type/{{name}}` | `conn_mod_def::GJkDjjqTJRA::4ysGM7yJRvC1_8CVU0RnOw` | | Patch a Stream Event Type | PATCH | `/api/v1/stream/event-type/{{name}}` | `conn_mod_def::GJkDjd16gNA::4yO07RUPSm-lUMPay5NZMg` | | Update a Stream Event Type | PUT | `/api/v1/stream/event-type/{{name}}` | `conn_mod_def::GJkDjXX0ZcA::zcy4_-qORd2CpXXTfxeqAA` | ### Application | Action | Method | Path | Action id | |---|---|---|---| | Get an Application | GET | `/api/v1/app/{{app_id}}` | `conn_mod_def::GJkDVap0i8g::VtXPSFCLTHiagCPXlZwB6w` | | Create Application | POST | `/api/v1/app` | `conn_mod_def::GJkDVUMntOA::RI84h95KRjGMcpLOjwYToA` | | Delete an Application | DELETE | `/api/v1/app/{{app_id}}` | `conn_mod_def::GJkDV6rgFLg::GYmmaq4_RQ2w-ynX5eH6zA` | | Patch an Application | PATCH | `/api/v1/app/{{app_id}}` | `conn_mod_def::GJkDV0lEyqA::nibm0_1OQwGe-0YU90ddBw` | | Update an Application | PUT | `/api/v1/app/{{app_id}}` | `conn_mod_def::GJkDVtC17Bg::kwGIXy-2TPiAdg0zWV_YJg` | ### IngestSource | Action | Method | Path | Action id | |---|---|---|---| | Get an Ingest Source | GET | `/ingest/api/v1/source/{{source_id}}` | `conn_mod_def::GJkDcr4Bphg::rJjp2GbATiCCrQXrWxU98w` | | Create an Ingest Source | POST | `/ingest/api/v1/source` | `conn_mod_def::GJkDcl3CbXg::vaxZNjOSTqWQQC9NaV9ysQ` | | Delete an Ingest Source | DELETE | `/ingest/api/v1/source/{{source_id}}` | `conn_mod_def::GJkDc4pC_Gg::tkldXCw6R9qIIDES4F365Q` | | Rotate an Ingest Source’s Token | POST | `/ingest/api/v1/source/{{source_id}}/token/rotate` | `conn_mod_def::GJkDdIAiWGg::ThxY2icSQX-hpIZq-XrnEA` | | Update an Ingest Source | PUT | `/ingest/api/v1/source/{{source_id}}` | `conn_mod_def::GJkDcyeiokg::qQSxxJREQjGfbpy4CCnngw` | ### Connector | Action | Method | Path | Action id | |---|---|---|---| | Get a Connector | GET | `/api/v1/connector/{{connector_id}}` | `conn_mod_def::GJkDW-CPUYg::FLOS-35GTRCJ6fxWdIRV8Q` | | Create Connector | POST | `/api/v1/connector` | `conn_mod_def::GJkDW1zlO7g::zehqOKz8THCoS9BN8Lxd5A` | | Delete a Connector | DELETE | `/api/v1/connector/{{connector_id}}` | `conn_mod_def::GJkDXTwVSpg::RMw7_JGgTB2WoaPga6oVTw` | | Patch a Connector | PATCH | `/api/v1/connector/{{connector_id}}` | `conn_mod_def::GJkDXL4gilg::9wi1Y19nSSO0G0GM2Czdxg` | | Update a Connector | PUT | `/api/v1/connector/{{connector_id}}` | `conn_mod_def::GJkDXFLuBTA::p9xC6jAJSSaJikYpvfQZ0w` | ### EventType | Action | Method | Path | Action id | |---|---|---|---| | Get an Event Type | GET | `/api/v1/event-type/{{event_type_name}}` | `conn_mod_def::GJkDaomJ0MA::KCuwM5lxQgaYvHNZPcl3xw` | | Archive (Delete) an Event Type | DELETE | `/api/v1/event-type/{{event_type_name}}` | `conn_mod_def::GJkDa8xUlMA::QkmaterMRICXAnoZiLwGnw` | | Create Event Type | POST | `/api/v1/event-type` | `conn_mod_def::GJkDaa1e3rA::WP6LyRhFShWkemOqzi91iw` | | Patch an Event Type | PATCH | `/api/v1/event-type/{{event_type_name}}` | `conn_mod_def::GJkDa1H5HCg::rotHee2TSyGP0hjedCbxmA` | | Update an Event Type | PUT | `/api/v1/event-type/{{event_type_name}}` | `conn_mod_def::GJkDavLwa6A::5VXhYj4eSEmmpB4qPyYsvw` | ### StreamSink | Action | Method | Path | Action id | |---|---|---|---| | Get a Stream’s Sink | GET | `/api/v1/stream/{{stream_id}}/sink/{{sink_id}}` | `conn_mod_def::GJkDgalLq7A::gpaZAD-IQ1eba72_7CB-XA` | | Create a Stream Sink | POST | `/api/v1/stream/{{stream_id}}/sink` | `conn_mod_def::GJkDgTb3siA::uLsY9RASQTuURC7mIw_VCw` | | Delete a Stream Sink | DELETE | `/api/v1/stream/{{stream_id}}/sink/{{sink_id}}` | `conn_mod_def::GJkDgwnJQAA::DGUAjx9ESte_HBT5CmzyQg` | | Patch a Stream’s Sink | PATCH | `/api/v1/stream/{{stream_id}}/sink/{{sink_id}}` | `conn_mod_def::GJkDgpFLm6A::kkf60GqhQQu_m1Qb8zF5bQ` | | Update a Stream Sink | PUT | `/api/v1/stream/{{stream_id}}/sink/{{sink_id}}` | `conn_mod_def::GJkDgiztbLA::CMcxUecUQDCQmzaTTfhfJQ` | ### OperationalWebhookEndpoint | Action | Method | Path | Action id | |---|---|---|---| | Get an Operational Webhook Endpoint | GET | `/api/v1/operational-webhook/endpoint/{endpoint_id}` | `conn_mod_def::GJkDj7X6neA::UK1Q4FLfTDaola7WZArR0g` | | Create an Operational Webhook Endpoint | POST | `/api/v1/operational-webhook/endpoint` | `conn_mod_def::GJkDjzCA4MA::E8i80x9YS-K6wvdH3lPNZA` | | Delete an Operational Webhook Endpoint | DELETE | `/api/v1/operational-webhook/endpoint/{{endpoint_id}}` | `conn_mod_def::GJkDkJD083g::RrHsL1WcRGOi2d6HAYeLmw` | | Update an Operational Webhook Endpoint | PUT | `/api/v1/operational-webhook/endpoint/{{endpoint_id}}` | `conn_mod_def::GJkDkBTpnEg::Sw7wPwapT76s50W8JSZJyw` | ### AppIntegration | Action | Method | Path | Action id | |---|---|---|---| | Get an App Integration | GET | `/api/v1/app/{{app_id}}/integration/{{integ_id}}` | `conn_mod_def::GJkDdb-8EFg::dplXgRTQR4-IdWbTfW9prQ` | | Create an App Integration | POST | `/api/v1/app/{{app_id}}/integration` | `conn_mod_def::GJkDdVk70HA::RyLIlVcGTvOssetxUmb4kg` | | Delete an App Integration | DELETE | `/api/v1/app/{{app_id}}/integration/{{integ_id}}` | `conn_mod_def::GJkDdq2FhdA::4zr2YRNOQEmaC1PaRUFg0Q` | | Update an App Integration | PUT | `/api/v1/app/{{app_id}}/integration/{{integ_id}}` | `conn_mod_def::GJkDdkifK4A::8Qid3NCITlinewdWq0kbMA` | ### BackgroundTask | Action | Method | Path | Action id | |---|---|---|---| | Get a Background Task | GET | `/api/v1/background-task/{{task_id}}` | `conn_mod_def::GJkDWnrkBmg::Alz1F0YLTRGvZ1GPzo1HxA` | | List Background Tasks | GET | `/api/v1/background-task` | `conn_mod_def::GJkDWcACTfA::zszSjZGDQUq4mQItPdcHsg` | | Aggregate an Organization’s Usage Event Types (Background Task) | PUT | `/api/v1/stats/usage/event-types` | `conn_mod_def::GJkDhthDufg::0QUTSHKCToylMje8uarnhQ` | ### OperationalWebhookEndpointHeaders | Action | Method | Path | Action id | |---|---|---|---| | Get an Operational Webhook Endpoint's Additional Headers | GET | `/api/v1/operational-webhook/endpoint/{{endpoint_id}}/headers` | `conn_mod_def::GJkDkS1u-vA::xLllrXgORIyhOqdYv4GqHg` | | Update an Operational Webhook Endpoint's Headers | PUT | `/api/v1/operational-webhook/endpoint/{{endpoint_id}}/headers` | `conn_mod_def::GJkDkYe1vmg::yqUbu1FBSHyb4f5tFi6Ozw` | ### OperationalWebhookEndpointSecret | Action | Method | Path | Action id | |---|---|---|---| | Get an Operational Webhook Endpoint Secret | GET | `/api/v1/operational-webhook/endpoint/{{endpoint_id}}/secret` | `conn_mod_def::GJkDkfTrQ2g::WDBsA5H3SECeaGOwB2X1Kw` | | Rotate an Operational Webhook Endpoint’s Secret | POST | `/api/v1/operational-webhook/endpoint/{{endpoint_id}}/secret/rotate` | `conn_mod_def::GJkDkmj_FWg::SBLj0HpQRKyEybZZX7etgg` | ### EndpointTransformation | Action | Method | Path | Action id | |---|---|---|---| | Get an Endpoint's Transformation | GET | `/api/v1/app/{{app_id}}/endpoint/{{endpoint_id}}/transformation` | `conn_mod_def::GJkDZjxHCkg::_JjTXhQrQMeXrIF7P3BVVQ` | | Set an App Endpoint’s Transformation (Patch) | PATCH | `/api/v1/app/{{app_id}}/endpoint/{{endpoint_id}}/transformation` | `conn_mod_def::GJkDZq0eIAg::N2WTo9BdQa6v2CqCGnye7g` | ### Environment | Action | Method | Path | Action id | |---|---|---|---| | Export Environment Configuration | POST | `/api/v1/environment/export` | `conn_mod_def::GJkDZxUtCog::HZjtfUlsTa6EqH24cEqEEQ` | | Import Environment Configuration into the Active Organization | POST | `/api/v1/environment/import` | `conn_mod_def::GJkDZ5L6o1g::sFFbbyTbQcKtd_AsTRVmiA` | ### StreamSinkHeaders | Action | Method | Path | Action id | |---|---|---|---| | Get a Stream Sink’s Headers | GET | `/api/v1/stream/{{stream_id}}/sink/{{sink_id}}/headers` | `conn_mod_def::GJkDg2-QLoA::BWGS-Rn4TzO_o2jh0bIfxA` | | Patch a Stream Sink's Headers | PATCH | `/api/v1/stream/{{stream_id}}/sink/{{sink_id}}/headers` | `conn_mod_def::GJkDg9hK0fA::ei3L4yZaS0-8I4Hr64FBxQ` | ### StreamSinkSecret | Action | Method | Path | Action id | |---|---|---|---| | Get a Stream Sink's Secret | GET | `/api/v1/stream/{{stream_id}}/sink/{{sink_id}}/secret` | `conn_mod_def::GJkDhEeBHHg::dX5PCY43TcaEEyWqvA0HCQ` | | Rotate a Stream Sink Secret | POST | `/api/v1/stream/{{stream_id}}/sink/{{sink_id}}/secret/rotate` | `conn_mod_def::GJkDhMd-uJA::kNb-UXilTYCc2W1wc4GTng` | ### Auth | Action | Method | Path | Action id | |---|---|---|---| | Logout (App Token) | POST | `/api/v1/auth/logout` | `conn_mod_def::GJkDWRgiWjA::luSRUKghS9mWW2E44whHrw` | | Stream Logout (Stream Token) | POST | `/api/v1/auth/stream-logout` | `conn_mod_def::GJkDibUXhEg::VQeIvATZQu-GG8lnhLWNmw` | ### ApplicationEndpoint | Action | Method | Path | Action id | |---|---|---|---| | Create an Application Endpoint | POST | `/api/v1/app/{{app_id}}/endpoint` | `conn_mod_def::GJkDXiyrMjg::iGk2svF1RfuDklx9T59ICA` | | Update an Application Endpoint | PUT | `/api/v1/app/{{app_id}}/endpoint/{{endpoint_id}}` | `conn_mod_def::GJkDX6pXILA::zspMSJmdQ0WDgueZ7mDJfA` | ### Endpoint | Action | Method | Path | Action id | |---|---|---|---| | Get an App Endpoint | GET | `/api/v1/app/{{app_id}}/endpoint/{{endpoint_id}}` | `conn_mod_def::GJkDXwcCF_g::MMal3m_aR4uUi-Wom8Y4Ng` | | Partially Update an App Endpoint | PATCH | `/api/v1/app/{{app_id}}/endpoint/{{endpoint_id}}` | `conn_mod_def::GJkDYCK9trg::Mm3jVhdNTmyhiUqNWbw2Ww` | ### AppEndpointHeaders | Action | Method | Path | Action id | |---|---|---|---| | Get an App Endpoint’s Headers | GET | `/api/v1/app/{{app_id}}/endpoint/{{endpoint_id}}/headers` | `conn_mod_def::GJkDYY29Q9g::q0w05YXwRIOa8WK1RbP6UA` | | Update an App Endpoint’s Additional Headers | PUT | `/api/v1/app/{{app_id}}/endpoint/{{endpoint_id}}/headers` | `conn_mod_def::GJkDYiOfI1g::_a5J1gjKTYOswHKvZJTPSA` | ### EndpointSecret | Action | Method | Path | Action id | |---|---|---|---| | Get an App Endpoint's Secret | GET | `/api/v1/app/{{app_id}}/endpoint/{{endpoint_id}}/secret` | `conn_mod_def::GJkDZFQISXg::UiPRO4RwSxOF0ix5Pnlc3Q` | | Rotate an App Endpoint's Secret | POST | `/api/v1/app/{{app_id}}/endpoint/{{endpoint_id}}/secret/rotate` | `conn_mod_def::GJkDZNFNWSg::qQCQixOlTHGWwoNGqU3kAQ` | ### EventTypes | Action | Method | Path | Action id | |---|---|---|---| | List Event Types | GET | `/api/v1/event-type` | `conn_mod_def::GJkDaUYu6lA::wyiQf1C3RGSKHSCHSI6Ocg` | | Import Event Types From an OpenAPI Spec | POST | `/api/v1/event-type/import/openapi` | `conn_mod_def::GJkDaiZOfsA::VDt3aGnRRCWeZXC8jdqR1w` | ### IngestEndpoint | Action | Method | Path | Action id | |---|---|---|---| | Get an Ingest Endpoint | GET | `/ingest/api/v1/source/{{source_id}}/endpoint/{{endpoint_id}}` | `conn_mod_def::GJkDbbqcIlA::obXf9R5dQNaJeZax_g-DLA` | | Create an Ingest Endpoint for a Source | POST | `/ingest/api/v1/source/{{source_id}}/endpoint` | `conn_mod_def::GJkDbUZoAsg::WBMHnxmLS7iXA5bbMlaMSw` | ### IntegrationKey | Action | Method | Path | Action id | |---|---|---|---| | Get an App Integration's Key | GET | `/api/v1/app/{{app_id}}/integration/{{integ_id}}/key` | `conn_mod_def::GJkDdx8PWWA::FJga228ISeOdQeziWAP7Gw` | | Rotate an App Integration's Key | POST | `/api/v1/app/{{app_id}}/integration/{{integ_id}}/key/rotate` | `conn_mod_def::GJkDd5MXwYA::63vB0xxBTxeIPx4qJv8geg` | ### Messages | Action | Method | Path | Action id | |---|---|---|---| | List an App’s Messages | GET | `/api/v1/app/{{app_id}}/msg` | `conn_mod_def::GJkDeB4eSUg::1X-HVYS1RBG3slA4Lea4XQ` | | Create a Message for an Application | POST | `/api/v1/app/{{app_id}}/msg` | `conn_mod_def::GJkDeKoVuPA::a-yvRtmuRWGIKB09RhvUAw` | ### Attempts | Action | Method | Path | Action id | |---|---|---|---| | List Attempts By Endpoint (for an App) | GET | `/api/v1/app/{{app_id}}/attempt/endpoint/{{endpoint_id}}` | `conn_mod_def::GJkDfNXG9hg::PEs6mqmEQoKCeJsjN25jWA` | | List Attempts by Message (for an App) | GET | `/api/v1/app/{{app_id}}/attempt/msg/{{msg_id}}` | `conn_mod_def::GJkDfWdM-XA::u1PWkj_ETSugM7k5Nu8G3A` | ### StreamPollerToken | Action | Method | Path | Action id | |---|---|---|---| | Get a Stream Poller Token | GET | `/api/v1/auth/stream/{{stream_id}}/sink/{{sink_id}}/poller/token` | `conn_mod_def::GJkDixaAMDA::p7vfttohQLCrz8Lj9KvN_w` | ### StreamSinkPollerToken | Action | Method | Path | Action id | |---|---|---|---| | Rotate a Stream Sink’s Poller Token | POST | `/api/v1/auth/stream/{{stream_id}}/sink/{{sink_id}}/poller/token/rotate` | `conn_mod_def::GJkDi4uOBhg::CKwkR5ZmQFauwAeICRc0CQ` | ### StreamEventTypes | Action | Method | Path | Action id | |---|---|---|---| | List Stream Event Types | GET | `/api/v1/stream/event-type` | `conn_mod_def::GJkDjAskHjA::UI4i3nE6TIGzF31m9bQCxQ` | ### StreamPortalAccess | Action | Method | Path | Action id | |---|---|---|---| | Get Stream Portal Access | POST | `/api/v1/auth/stream-portal-access/{{stream_id}}` | `conn_mod_def::GJkDiiyyYfg::oE9cBve9Q7e5HLmFz2ALaw` | ### EndpointStats | Action | Method | Path | Action id | |---|---|---|---| | Get an App Endpoint’s Stats | GET | `/api/v1/app/{{app_id}}/endpoint/{{endpoint_id}}/stats` | `conn_mod_def::GJkDZdDtYZg::WG7AkR6SQc-ig4zMppdU9w` | ### IngestEndpointSecret | Action | Method | Path | Action id | |---|---|---|---| | Get an Ingest Endpoint's Secret | GET | `/ingest/api/v1/source/{{source_id}}/endpoint/{{endpoint_id}}/secret` | `conn_mod_def::GJkDb-VZXQg::nhtfSZq0TzSUe0rMQ6pqHg` | ### IngestEndpointTransformation | Action | Method | Path | Action id | |---|---|---|---| | Get an Ingest Endpoint's Transformation | GET | `/ingest/api/v1/source/{{source_id}}/endpoint/{{endpoint_id}}/transformation` | `conn_mod_def::GJkDcQ8jbug::hU7sqR90TwuubYK-uwV0Tg` | ### Streams | Action | Method | Path | Action id | |---|---|---|---| | List Streams | GET | `/api/v1/stream` | `conn_mod_def::GJkDh0gM7eA::4yqCl2Z7QMCpI1_v_AxDuQ` | ### StreamTokens | Action | Method | Path | Action id | |---|---|---|---| | Expire All Tokens for a Stream | POST | `/api/v1/auth/stream/{{stream_id}}/expire-all` | `conn_mod_def::GJkDirIYxfg::7-KwzvezR_mdhYxOTp5SHw` | ### OperationalWebhookEndpoints | Action | Method | Path | Action id | |---|---|---|---| | List Operational Webhook Endpoints | GET | `/api/v1/operational-webhook/endpoint` | `conn_mod_def::GJkDjp0E6Wg::pbw7hjhmTue_XjqVe1bGvg` | ### Applications | Action | Method | Path | Action id | |---|---|---|---| | List Applications | GET | `/api/v1/app` | `conn_mod_def::GJkDVNOEaBg::rMdUsyYNSuSGigX5GIsoJg` | ### ConsumerAppPortalAccess | Action | Method | Path | Action id | |---|---|---|---| | Get Consumer App Portal Access for an Application | POST | `/api/v1/auth/app-portal-access/{{app_id}}` | `conn_mod_def::GJkDWEbA_Pg::rZKYEUl-TUW0VNoMXJVcQg` | This lists 90 of 127 actions. For anything not here, call `search_one_platform_actions` with platform `svix`. The full catalog is at https://www.withone.ai/knowledge/svix. ## When a call fails The error comes from Svix, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed. Full catalog: https://www.withone.ai/knowledge/svix Integration knowledge by One (withone.ai), licensed under [One-Knowledge-1.0](https://www.withone.ai/licenses/knowledge). Attribution must be preserved in derivative works.