# Artie > Artie is a real-time data replication platform. It uses change data capture (CDC) to stream changes from operational databases (PostgreSQL, MySQL, MariaDB, MongoDB, Oracle, Microsoft SQL Server, DynamoDB, DocumentDB, CockroachDB, Amazon Keyspaces, and PlanetScale) into warehouses and lakehouses including Snowflake, BigQuery, Databricks, Redshift, ClickHouse, MotherDuck, Apache Iceberg, and Delta Lake, with sub-minute latency. Pipelines are managed from the Artie Dashboard, the Dashboard API, the Terraform provider, or the hosted MCP server. All documentation pages are available as clean Markdown by appending `.md` to any URL (e.g. `https://artie.com/docs/quickstart.md`). Use these Markdown URLs for full content. The complete documentation in a single file is at https://artie.com/docs/llms-full.txt. ## Instructions for AI coding assistants When helping a developer set up or use Artie, follow these guidelines: - **Use the current Artie docs**: Artie's connectors, API endpoints, and MCP tools change frequently. Read the relevant `.md` page before answering, and start from the [MCP server guide](https://artie.com/docs/api/mcp.md) when configuring a client. Do not rely on training data for endpoint paths, field names, or tool behavior. - **Connect the hosted Artie MCP server**: Configure the user's MCP-compatible client with the remote Streamable HTTP endpoint below. Authentication is OAuth only. Do not add an Artie API key or a bearer-token header. ```text https://mcp.artie.com/mcp ``` - **Enumerate MCP tools before calling them**: The connected server is the source of truth for which tools exist, their exact parameters, and which ones mutate or delete resources. Do not assume a tool exists based on training data. - **Never auto-approve destructive tools**: Some tools stop pipelines, delete resources, or rotate encryption and ingestion API keys, any of which can interrupt dependent workloads. Confirm the exact action and the affected resource with the user before authorizing a call. - **Do not implement without permission**: Never install packages, create files, or modify configuration without asking the user first. - **Do not add unrelated integrations**: Only configure the pipelines, connectors, and features the user asked for. Check before enabling anything else. - **Treat connector credentials as secrets**: `connector_create`, `unsaved_connector_ping`, and `source_reader_update` send credentials, and `connector_detail` and `source_reader_detail` can return them. Confirm before sending, don't echo passwords or keys, and never commit API keys or database secrets. - **Manage Artie as code with Terraform**: For reproducible pipeline and connector configuration, prefer the official [Artie Terraform provider](https://registry.terraform.io/providers/artie-labs/artie/latest) over ad-hoc API scripts. ## Getting started - [Quickstart](https://artie.com/docs/quickstart.md): Get started with Artie and learn how to set up your first pipeline. - [Overview](https://artie.com/docs/connection-options.md): See the various ways Artie is able to connect to your database. - [AWS PrivateLink](https://artie.com/docs/connection-options/privatelink.md): Artie supports connections through AWS PrivateLink. You can configure PrivateLink directly from the Artie dashboard. - [Azure Private Link](https://artie.com/docs/connection-options/azure-private-link.md): Artie supports connections through Azure Private Link. You can configure Private Link directly from the Artie dashboard. - [AWS VPC Lattice](https://artie.com/docs/connection-options/vpc-lattice.md): In BYOC deployments, connect Artie to databases spread across multiple AWS accounts and VPCs through VPC Lattice resource configurations, without peering, NLBs, or a PrivateLink endpoint service per VPC. - [SSH tunnel](https://artie.com/docs/connection-options/ssh-tunnel.md): An SSH tunnel is a secure method of forwarding network traffic between your local machine and a remote server through an encrypted SSH (Secure Shell) connection. - [Architecture](https://artie.com/docs/concepts/architecture.md): Learn about Artie's split plane architecture that separates control and data planes for enhanced security and flexibility. - [Glossary](https://artie.com/docs/glossary.md): Definitions of key terms and concepts used throughout the Artie documentation. ## Pipelines - [Pipelines](https://artie.com/docs/pipelines/overview.md): Learn how Artie pipelines replicate data from your source to your destination in real time. - [Backfills](https://artie.com/docs/pipelines/backfill.md): Artie runs CDC and backfills in parallel without data conflicts or database load. Database changes are enqueued in Kafka as the backfill is running and applied after backfill completes. - [Overview](https://artie.com/docs/pipelines/flush-rules/overview.md): Control how often data is loaded into your destination with Artie's flush rules. Balance between performance, latency and resource usage to optimize your data pipeline. - [Tuning flush rules](https://artie.com/docs/pipelines/flush-rules/tuning.md): Learn how to tune Artie's flush rules for optimal performance based on your destination type, data volume, and latency requirements. - [Force flush](https://artie.com/docs/pipelines/flush-rules/force-flush.md): Flush a pipeline to its destination at least every 30 seconds for 2 hours, then return to your normal flush settings automatically. - [Tables](https://artie.com/docs/pipelines/tables.md): Learn how to replicate, configure, and manage tables in Artie. - [System columns](https://artie.com/docs/pipelines/system-columns.md): Artie adds system columns to your destination tables for change tracking, soft deletes, and source metadata. ## Managed Kafka - [Artie Managed Kafka](https://artie.com/docs/managed-kafka/overview.md): Artie Managed Kafka runs Apache Kafka clusters for you on AWS. You own the topics and the data; Artie runs the brokers, machines, storage, and TLS. - [Create a Managed Kafka cluster](https://artie.com/docs/managed-kafka/create-a-cluster.md): Create an Artie Managed Kafka cluster from the Artie Dashboard: pick a name, region, and size, choose which IP ranges can connect, and start the brokers. - [Connect to your Managed Kafka cluster](https://artie.com/docs/managed-kafka/connect.md): Connect Kafka clients to an Artie Managed Kafka cluster over TLS with SASL/SCRAM-SHA-512, using the bootstrap server and admin login from the Artie Dashboard. - [Manage your Managed Kafka cluster](https://artie.com/docs/managed-kafka/manage.md): Create and delete topics, change retention, edit the IP allowlist, generate a new password, resize, and delete or restore an Artie Managed Kafka cluster. - [Managed Kafka limits and specs](https://artie.com/docs/managed-kafka/limits.md): Regions, broker counts, instance types, storage sizes, retention limits, and account limits for Artie Managed Kafka clusters. ## Sources - [Amazon Keyspaces](https://artie.com/docs/sources/cassandra.md): Learn how to configure Amazon Keyspaces as a source in Artie, including service account setup, cluster configuration, and enabling CDC streams on your tables. - [CockroachDB](https://artie.com/docs/sources/cockroach.md): Learn how to use Artie to replicate data from CockroachDB. - [DocumentDB](https://artie.com/docs/sources/documentdb.md): Learn how to use Artie to replicate data from DocumentDB via change streams. - [DynamoDB source setup](https://artie.com/docs/sources/dynamodb.md): Configure DynamoDB as a source in Artie using DynamoDB Streams, point-in-time recovery backfills, and S3 export for efficient data replication. - [MariaDB source setup](https://artie.com/docs/sources/mariadb.md): Configure MariaDB as a source in Artie with binlog replication, service account setup, and GTID support through Artie's MySQL connector. - [Overview](https://artie.com/docs/sources/events-api/overview.md): Introduction to the Events API for ingesting analytics and tracking events. - [Track a single event](https://artie.com/docs/api-reference/track-a-single-event.md): Accepts a single event object and records it for ingestion. If `messageId` is not provided, the server will generate one automatically. - [Track multiple events in bulk](https://artie.com/docs/api-reference/track-multiple-events-in-bulk.md): Accepts an array of event objects and records them in bulk. Clients may optionally gzip the request body. The total uncompressed request size must not exceed 10 MB. - [Microsoft SQL Server source: choosing a replication method](https://artie.com/docs/sources/microsoft-sql-server/overview.md): Compare Artie's three ways to replicate Microsoft SQL Server (CDC capture instances, change tracking, and transaction log backups) by what they capture, latency, and load on the database. - [Microsoft SQL Server source: CDC capture instances](https://artie.com/docs/sources/microsoft-sql-server/capture-instances.md): Replicate Microsoft SQL Server with native CDC capture instances: service account, enabling CDC on databases and tables, retention, schema changes, and how Artie reads change tables. - [Microsoft SQL Server source: change tracking](https://artie.com/docs/sources/microsoft-sql-server/change-tracking.md): Replicate Microsoft SQL Server with change tracking when CDC isn't available: permissions, enabling change tracking, retention, and what change tracking does and doesn't capture. - [Microsoft SQL Server source: transaction log backups](https://artie.com/docs/sources/microsoft-sql-server/transaction-log-backups.md): Replicate Microsoft SQL Server by reading its transaction log backups (.trn files) from an SMB share, with supplemental logging so updates are read from the log instead of the database. - [Microsoft SQL Server source: high availability and failover](https://artie.com/docs/sources/microsoft-sql-server/high-availability.md): How Artie replicates SQL Server in Always On availability groups: connecting through the listener, what carries over on failover, CDC jobs on every replica, log backups across replicas, and Artie's delivery guarantees. - [MongoDB](https://artie.com/docs/sources/mongodb.md): Learn how to use Artie to replicate data from MongoDB via change streams. - [MySQL source setup](https://artie.com/docs/sources/mysql.md): Configure MySQL as a source in Artie with binlog replication, service account setup, GTID support, and automatic gh-ost migration handling. - [PlanetScale source setup](https://artie.com/docs/sources/planetscale.md): Connect PlanetScale to Artie for real-time CDC using the Vitess VStream API. No binlog configuration required. - [Amazon S3 Source](https://artie.com/docs/sources/s3.md): Ingest CSV, JSON, Parquet, and ACH files from Amazon S3 into an Artie destination. - [Oracle source: setup and configuration](https://artie.com/docs/sources/oracle/overview.md): Configure Oracle as a source in Artie with archive logs, LogMiner, supplemental logging, and service account permissions for both single-tenant and multi-tenant architectures. - [Amazon RDS](https://artie.com/docs/sources/oracle/amazon-rds.md): Learn how to configure Amazon RDS for Oracle as a source in Artie, including archive log mode, supplemental logging, LogMiner access, and service account permissions. - [PostgreSQL Source Connector: Setup and Configuration](https://artie.com/docs/sources/postgresql.md): Configure PostgreSQL as a source in Artie with logical replication, partitioned tables, TOAST column handling, publication management, and provider-specific setup guides. - [Amazon Aurora and RDS](https://artie.com/docs/sources/postgresql/amazon-rds.md): Learn how to configure Amazon Aurora and RDS for PostgreSQL as a source in Artie, including service account creation, publication setup, and enabling logical replication. - [Google Cloud SQL](https://artie.com/docs/sources/postgresql/gcp-cloudsql.md): Learn how to configure GCP CloudSQL for PostgreSQL as a source in Artie, including service account creation, publication setup, and enabling logical decoding. - [PlanetScale for Postgres](https://artie.com/docs/sources/postgresql/planetscale.md): Learn how to configure PlanetScale for Postgres as a source in Artie, including service account creation, heartbeats, publication setup, enabling logical replication, and failover-safe replication slots. - [Supabase PostgreSQL source setup](https://artie.com/docs/sources/postgresql/supabase.md): Connect Supabase PostgreSQL as a source in Artie with IPv4 setup, credential configuration, service account creation, and logical replication publishing. - [Troubleshooting](https://artie.com/docs/sources/postgresql/troubleshooting.md): Common PostgreSQL replication issues and how to resolve them. - [Snowflake source: setup and configuration](https://artie.com/docs/sources/snowflake.md): Configure Snowflake as a source in Artie with key-pair authentication, a read-only service user, and change tracking on each table you replicate. ## Destinations - [BigQuery](https://artie.com/docs/destinations/bigquery.md): Learn how to configure Google BigQuery as a destination in Artie, including project setup, dataset configuration, service account credentials, and query priority settings. - [ClickHouse](https://artie.com/docs/destinations/clickhouse.md): Configure ClickHouse Cloud as a destination in Artie with required settings including warehouse address, service account credentials, and setup instructions. - [Databricks](https://artie.com/docs/destinations/databricks.md): Learn how to configure Databricks as a destination in Artie, including SQL warehouse connection details, Unity Catalog setup, volume configuration, and authentication. - [Delta Lake (S3)](https://artie.com/docs/destinations/delta.md): How to configure Delta Lake as a destination in Artie. With Delta Lake, Artie writes incoming changes in Parquet format to the specified S3 bucket, checkpointed as a Delta table. - [Google Cloud Storage](https://artie.com/docs/destinations/gcs.md): How to configure [Google Cloud Storage (GCS)](https://cloud.google.com/storage) as an append-only Parquet destination in Artie. - [S3 Tables](https://artie.com/docs/destinations/iceberg/s3tables.md): Learn how to configure Amazon S3 Tables as an Iceberg destination in Artie, including table bucket setup and IAM service account permissions. - [REST catalog](https://artie.com/docs/destinations/iceberg/rest_catalog.md): How to configure Iceberg REST Catalog as a destination in Artie - [Kafka Destination Connector: Setup and Configuration](https://artie.com/docs/destinations/kafka.md): Publish change events from your source database to your own Apache Kafka or Amazon MSK cluster. Artie writes one topic per table as Debezium JSON, with SASL, AWS MSK IAM, TLS, and mutual TLS support. - [MariaDB](https://artie.com/docs/destinations/mariadb.md): Learn how to configure MariaDB as a destination in Artie through the MySQL destination, including service account creation, supported versions, and how JSON columns are stored. - [Microsoft SQL Server](https://artie.com/docs/destinations/microsoft-sql-server.md): How to configure Microsoft SQL Server as a destination in Artie - [MotherDuck](https://artie.com/docs/destinations/motherduck.md): Configure MotherDuck as a destination in Artie. Learn how to create access tokens, set up your pipeline database, and share data across your organization. - [MySQL](https://artie.com/docs/destinations/mysql.md): Learn how to configure MySQL as a destination in Artie, including host and port settings, service account creation, and the required database permissions for real-time replication. - [Oracle](https://artie.com/docs/destinations/oracle.md): How to configure Oracle as a destination in Artie: connecting to a pluggable database's service name, creating the service account, choosing schemas, and how Artie maps column types. - [PostgreSQL](https://artie.com/docs/destinations/postgres.md): Learn how to configure PostgreSQL as a destination in Artie, including host and port settings, service account creation, schema ownership, and the required database permissions. - [Databricks Lakebase](https://artie.com/docs/destinations/postgres/databricks-lakebase.md): Connect Artie to a Databricks Lakebase Postgres destination with OAuth, using a Databricks service principal instead of a database password. - [Redis destination connector: setup and configuration](https://artie.com/docs/destinations/redis.md): Configure Redis as a destination in Artie. Artie writes each table's changes to a Redis Stream as JSON entries, with support for TLS, ACL users, SSH tunnels, Redis Cluster, and an optional cap on stream length. - [Redshift](https://artie.com/docs/destinations/redshift.md): Learn how to configure Amazon Redshift as a destination in Artie, including endpoint setup, schema configuration, service account creation, and required database permissions. - [S3](https://artie.com/docs/destinations/s3.md): How to configure S3 as an append-only Parquet destination in Artie. - [Snowflake](https://artie.com/docs/destinations/snowflake.md): Configure Snowflake as a destination in Artie with service account setup, key-pair authentication, and advanced features like turbo mode and eco mode. ## Monitoring - [Analytics portal](https://artie.com/docs/monitoring/analytics-portal.md): Monitor your Artie pipelines on the Analytics page. View rows synced, operation types, table distribution, ingestion lag, and more with filtering by pipeline and table. - [Integrations](https://artie.com/docs/monitoring/integrations.md): Send Artie pipeline metrics to Datadog, or over OpenTelemetry to New Relic, Amazon CloudWatch, Grafana, or any OTLP endpoint, and page a PagerDuty service from Artie alerts. - [Custom monitors](https://artie.com/docs/monitoring/custom-monitors.md): Create pipeline and table monitors for volume, ingestion lag, and PostgreSQL replication-slot size. - [Schema changes](https://artie.com/docs/monitoring/schema-changes.md): Stay up to date on schema changes in your source database. - [Available metrics](https://artie.com/docs/monitoring/available-metrics.md): Metrics that Artie Transfer emits over StatsD, and where to find the metrics Artie exports to your observability integrations. ## Artie Dashboard - [Managing your team](https://artie.com/docs/account/managing-your-team.md): Invite team members, assign roles, and manage email notification preferences from the Company members page. - [Environments](https://artie.com/docs/account/environments.md): Use environments to isolate pipelines, connectors, and other resources across dev, staging, and production. - [Enabling notifications](https://artie.com/docs/account/enabling-notifications.md): Artie can send alerts and notifications to different channels. This page will go over how to configure notifications across different channels. - [Legal](https://artie.com/docs/account/legal.md): Review Artie's legal documents, find security and compliance resources, and accept a Business Associate Agreement from Company settings. - [Email login codes](https://artie.com/docs/account/login-codes.md): Require a code sent by email when members sign in to the Artie dashboard with an email and password. - [Single sign-on (SSO)](https://artie.com/docs/account/sso/index.md): Set up single sign-on (SSO) for your Artie dashboard using any OIDC-compatible identity provider. - [Okta SSO](https://artie.com/docs/account/sso/okta.md): Configure single sign-on (SSO) for Artie using an Okta OIDC web application. - [Microsoft Entra ID SSO](https://artie.com/docs/account/sso/entra-id.md): Configure single sign-on (SSO) for Artie using a Microsoft Entra ID (Azure AD) app registration. - [Other OIDC providers](https://artie.com/docs/account/sso/other-providers.md): Configure single sign-on (SSO) for Artie using any OIDC-compliant identity provider. ## Guides - [Artie's typing library](https://artie.com/docs/guides/artie/arties-typing-library.md): Learn how Artie's internal typing library ensures data integrity and schema evolution across your data sources. - [Schema evolution](https://artie.com/docs/guides/artie/schema-evolution.md): Learn how Artie automatically evolves schemas to match your data. - [Column inclusion and exclusion](https://artie.com/docs/guides/artie/column-inclusion-exclusion.md): Learn how column inclusion and exclusion works in Artie. - [Soft partitioning](https://artie.com/docs/guides/artie/soft-partitioning.md): A logical partitioning strategy implemented at the ingestion layer for improved performance and data management - [Online migration](https://artie.com/docs/guides/artie/online-migration.md): Re-point or rebuild a pipeline with zero downtime by sharing a single source reader across the old and new pipelines. - [Rebuild and swap backfills](https://artie.com/docs/guides/artie/rebuild-and-swap.md): Reload a Snowflake table without downtime. Artie backfills into a new table and swaps it in when the load finishes, so the table stays queryable with complete data the whole time. - [Snowflake dynamic tables](https://artie.com/docs/guides/artie/dynamic-tables.md): Replicate high-throughput DynamoDB and Amazon Keyspaces tables into Snowflake by streaming every change into an append-only table and letting a Snowflake dynamic table keep the latest row per key. - [Write to multiple destinations](https://artie.com/docs/guides/artie/multiple-destinations.md): Split an existing pipeline into a shared source reader and independently replicate its changes to two destinations. - [Database migrations](https://artie.com/docs/guides/database/database-migrations.md): Learn how to safely perform database migrations while maintaining data replication with Artie. - [Preventing WAL growth on RDS Postgres](https://artie.com/docs/guides/database/preventing-postgres-wal-growth-on-rds.md): Learn how to prevent Write-Ahead Log (WAL) growth issues in your AWS RDS Postgres database, especially for low-traffic or test environments. - [Replicate PostgreSQL tables without primary keys](https://artie.com/docs/guides/database/tables-without-primary-key-s.md): Configure PostgreSQL tables without primary keys for replication by using REPLICA IDENTITY FULL and an Artie primary key override. - [Capacity pricing](https://artie.com/docs/guides/database/bigquery/capacity-pricing.md): Enable capacity pricing for BigQuery to avoid having unexpected BigQuery costs. - [Enable partitioning](https://artie.com/docs/guides/database/bigquery/enable-bigquery-partitioning.md): Partition your BigQuery destination tables to improve Artie merge performance and reduce costs. ## API reference - [Overview](https://artie.com/docs/api/overview.md): Get started with the Artie API to manage your pipelines and data programmatically. Includes authentication setup and API key generation. - [Query analytics data](https://artie.com/docs/api-reference/analytics/query-analytics-data.md): Queries Datadog metrics for analytics datasets such as rows synced, ingestion lag, flush time, and more. pipelineUUID is required for API keys bound to an environment. For windows of 59 minutes or longer, from and to are floored to 30 s and results are cached for up to 1 minute. - [List column hashing salts](https://artie.com/docs/api-reference/column-hashing-salts/list-column-hashing-salts.md): Lists all column hashing salts for the authenticated company. - [Create a column hashing salt](https://artie.com/docs/api-reference/column-hashing-salts/create-a-column-hashing-salt.md): Creates a new column hashing salt for the authenticated company. - [Delete a column hashing salt](https://artie.com/docs/api-reference/column-hashing-salts/delete-a-column-hashing-salt.md): Deletes a column hashing salt by UUID. - [Get a column hashing salt](https://artie.com/docs/api-reference/column-hashing-salts/get-a-column-hashing-salt.md): Retrieves a column hashing salt by UUID, including the decrypted salt. Requires company admin. - [Update a column hashing salt](https://artie.com/docs/api-reference/column-hashing-salts/update-a-column-hashing-salt.md): Updates the name and description of a column hashing salt. - [Preview a column hashing salt](https://artie.com/docs/api-reference/column-hashing-salts/preview-a-column-hashing-salt.md): Hashes a sample string value with this salt using the same function used by Artie's pipelines (HMAC-SHA256 keyed on the salt, or SHA-256 if the salt is empty). Returns the hex-encoded hash. - [Trigger automatic schema changes](https://artie.com/docs/api-reference/company/trigger-automatic-schema-changes.md): Enqueues automatic schema changes for all eligible running pipelines in the authenticated company. The request is accepted before reconciliation completes. - [List connectors](https://artie.com/docs/api-reference/connectors/list-connectors.md): Returns all destination connectors for the authenticated company. Pass includeSourceConnectors=true to also include source connectors. - [Create a connector](https://artie.com/docs/api-reference/connectors/create-a-connector.md): Creates a new source or destination connector for your Artie deployment. Configure database connections, authentication, and replication settings programmatically. - [Delete a connector](https://artie.com/docs/api-reference/connectors/delete-a-connector.md): Permanently removes a connector and its associated configuration. This stops any active replication pipelines that depend on the connector. - [Get a saved connector](https://artie.com/docs/api-reference/connectors/get-a-saved-connector.md): Retrieves the full configuration of a saved connector by uuid from connector_list, including type, label, and sharedConfig. Sensitive fields may be masked. - [Update a connector](https://artie.com/docs/api-reference/connectors/update-a-connector.md): Updates the configuration of an existing source or destination connector. Modify connection settings, credentials, or replication parameters for a running pipeline. - [Fetch databases for a saved connector](https://artie.com/docs/api-reference/connectors/fetch-databases-for-a-saved-connector.md): Lists available databases on the target using a saved connector's configuration. Response metadata may include Iceberg S3 table bucket maintenance defaults. - [Fetch table detail for a saved connector](https://artie.com/docs/api-reference/connectors/fetch-table-detail-for-a-saved-connector.md): Returns detailed metadata for a specific table on the saved connector. tableName is required; databaseName defaults to the connector's configured database, schemaName defaults to the connector type's default schema, and isView is optional. - [Generate Oracle shadow table script](https://artie.com/docs/api-reference/connectors/generate-oracle-shadow-table-script.md): Generates the SQL script to create shadow tables required for Oracle change data capture (CDC). Run this script on your Oracle source before starting replication. - [Drop a PostgreSQL replication slot](https://artie.com/docs/api-reference/connectors/drop-a-postgresql-replication-slot.md): Drops a PostgreSQL replication slot that is inactive or orphaned. Use this to clean up stale replication slots that may be preventing WAL cleanup on the source. - [List PostgreSQL replication slots](https://artie.com/docs/api-reference/connectors/list-postgresql-replication-slots.md): Lists replication slots on the PostgreSQL source for the specified connector. - [Fetch PostgreSQL settings](https://artie.com/docs/api-reference/connectors/fetch-postgresql-settings.md): Returns PostgreSQL server configuration settings relevant to replication for the specified connector. - [Fetch schemas for a saved connector](https://artie.com/docs/api-reference/connectors/fetch-schemas-for-a-saved-connector.md): Lists available schemas on the target using a saved connector's configuration. Pass 'databaseName' as a query parameter. - [Start a DynamoDB export](https://artie.com/docs/api-reference/connectors/start-a-dynamodb-export.md): Initiates a point-in-time export from Amazon DynamoDB for the specified connector. Use this to backfill your destination with existing DynamoDB table data. - [Fetch tables for a saved connector](https://artie.com/docs/api-reference/connectors/fetch-tables-for-a-saved-connector.md): Lists available tables on the target using a saved connector's configuration. databaseName defaults to the connector's configured database; schemaName defaults to the connector type's default schema (e.g. 'public' for Postgres, 'dbo' for SQL Server). - [Fetch databases for an unsaved connector](https://artie.com/docs/api-reference/connectors/fetch-databases-for-an-unsaved-connector.md): Lists available databases on the target using an unsaved connector configuration. Useful during connector setup to discover existing databases. Response metadata may include Iceberg S3 table bucket maintenance defaults. - [Create a database on an unsaved connector](https://artie.com/docs/api-reference/connectors/create-a-database-on-an-unsaved-connector.md): Creates a new database on the target destination using a connector configuration that has not yet been saved. Useful during initial setup to prepare the destination. - [Create a schema on an unsaved connector](https://artie.com/docs/api-reference/connectors/create-a-schema-on-an-unsaved-connector.md): Creates a new schema on the target destination using a connector configuration that has not yet been saved. Useful during initial setup to organize destination tables. - [Create a Snowflake warehouse on an unsaved connector](https://artie.com/docs/api-reference/connectors/create-a-snowflake-warehouse-on-an-unsaved-connector.md): Creates a new Snowflake virtual warehouse using an unsaved connector configuration. Useful during initial setup to provision compute resources for data replication. - [Ping a connector](https://artie.com/docs/api-reference/connectors/ping-a-connector.md): Tests network connectivity and authentication for a connector configuration before saving it. Pass type, sharedConfig, and connectionRole. Success is 204; a failed connection attempt returns 200 with an error message. - [List PostgreSQL publications for an unsaved connector](https://artie.com/docs/api-reference/connectors/list-postgresql-publications-for-an-unsaved-connector.md): Lists logical replication publications on a PostgreSQL source using an unsaved connector configuration. Useful during connector setup to let users select an existing publication. - [Fetch schemas for an unsaved connector](https://artie.com/docs/api-reference/connectors/fetch-schemas-for-an-unsaved-connector.md): Lists available schemas in a specific database using an unsaved connector configuration. Useful during connector setup to discover existing schemas. - [Fetch tables for an unsaved connector](https://artie.com/docs/api-reference/connectors/fetch-tables-for-an-unsaved-connector.md): Lists available tables in a specific database and schema using an unsaved connector configuration. Results are cached when a connector UUID is provided. - [Search the data catalog](https://artie.com/docs/api-reference/data-catalog/search-the-data-catalog.md): Searches across the company's data catalog using full-text search. - [List encryption keys](https://artie.com/docs/api-reference/encryption-keys/list-encryption-keys.md): Lists all encryption keys for the authenticated company. - [Create an encryption key](https://artie.com/docs/api-reference/encryption-keys/create-an-encryption-key.md): Creates a new encryption key for the authenticated company. - [Delete an encryption key](https://artie.com/docs/api-reference/encryption-keys/delete-an-encryption-key.md): Deletes an encryption key by UUID. - [Get an encryption key](https://artie.com/docs/api-reference/encryption-keys/get-an-encryption-key.md): Retrieves an encryption key by UUID, including the decrypted key. Requires company admin. - [Update an encryption key](https://artie.com/docs/api-reference/encryption-keys/update-an-encryption-key.md): Updates the name and description of an encryption key. - [Create an ingestion API key](https://artie.com/docs/api-reference/ingestion-api-keys/create-an-ingestion-api-key.md): Creates a new ingestion API key for a source reader. Returns the key and its secret (only shown once). - [Delete an ingestion API key](https://artie.com/docs/api-reference/ingestion-api-keys/delete-an-ingestion-api-key.md): Deletes an ingestion API key by UUID. - [Update an ingestion API key](https://artie.com/docs/api-reference/ingestion-api-keys/update-an-ingestion-api-key.md): Updates an existing ingestion API key by UUID. - [List Kafka clusters](https://artie.com/docs/api-reference/kafka-clusters/list-kafka-clusters.md): Retrieves the authenticated company's Managed Kafka clusters and, for a BYOC company with Kafka access enabled, the Kafka clusters on its own data plane. - [Create a Managed Kafka cluster](https://artie.com/docs/api-reference/kafka-clusters/create-a-managed-kafka-cluster.md): Saves a Managed Kafka cluster with status deploying and starts deploying it. An account on a public or disposable email domain, or an API key it made, gets a 403, unless an app setting allows them. A company not yet paying Artie needs a card on file first, or gets a 402. Company admins only. - [Delete a Managed Kafka cluster](https://artie.com/docs/api-reference/kafka-clusters/delete-a-managed-kafka-cluster.md): Deletes an active or failed Managed Kafka cluster, with its data. It leaves the list at once and is removed from AWS in the background. Returns 409 while the cluster is deploying. Company admins only. - [Get a Kafka cluster](https://artie.com/docs/api-reference/kafka-clusters/get-a-kafka-cluster.md): Retrieves a single Kafka cluster owned by the authenticated company, by UUID. - [Update a Managed Kafka cluster](https://artie.com/docs/api-reference/kafka-clusters/update-a-managed-kafka-cluster.md): Changes a cluster's name, allowlist, broker storage, storage autoscaling, instance type, broker count, or tiered storage. - [Get a Managed Kafka cluster's admin credentials](https://artie.com/docs/api-reference/kafka-clusters/get-a-managed-kafka-clusters-admin-credentials.md): Returns the username, password and client settings for logging in to a Managed Kafka cluster with SASL/SCRAM-SHA-512 over TLS. Returns 409 if the cluster isn't active or its password isn't ready yet. Company admins only. - [Generate a new Managed Kafka admin password](https://artie.com/docs/api-reference/kafka-clusters/generate-a-new-managed-kafka-admin-password.md): Gives the cluster's admin user a new random password and returns it once. - [Create an admin Kafka user](https://artie.com/docs/api-reference/kafka-clusters/create-an-admin-kafka-user.md): Creates an admin-profile Kafka user. - [Delete an admin Kafka user](https://artie.com/docs/api-reference/kafka-clusters/delete-an-admin-kafka-user.md): Deletes the admin-profile Kafka user. Kafka then revokes its credentials and ACLs, normally within seconds. Returns 204 once the user is deleted, or 200 with a warning while deletion is pending reconciliation. - [Get admin Kafka user credentials](https://artie.com/docs/api-reference/kafka-clusters/get-admin-kafka-user-credentials.md): Returns the admin-profile Kafka user's password, which lets the caller act as that user. - [Change a Managed Kafka cluster's allowlist](https://artie.com/docs/api-reference/kafka-clusters/change-a-managed-kafka-clusters-allowlist.md): Replaces the client IP ranges allowed to reach an active Managed Kafka cluster and applies them. No broker restarts. Returns 409 while any change to the cluster is still being applied. Company admins only. - [Add brokers to a Managed Kafka cluster](https://artie.com/docs/api-reference/kafka-clusters/add-brokers-to-a-managed-kafka-cluster.md): Adds brokers to an active Managed Kafka cluster and applies it: new machines, brokers, and one load balancer port each. - [Get every consumer group's detail](https://artie.com/docs/api-reference/kafka-clusters/get-every-consumer-groups-detail.md): Retrieves every consumer group's members and per-topic offset lag on a Managed Kafka cluster in one read. Results are cached for 10 seconds unless forceRefresh is true. Returns 400 for other clusters. - [List consumer groups](https://artie.com/docs/api-reference/kafka-clusters/list-consumer-groups.md): Retrieves the consumer groups for the cluster. Results are cached for two minutes (10 seconds on Managed Kafka clusters) unless forceRefresh is true. - [Get Kafka consumer group detail](https://artie.com/docs/api-reference/kafka-clusters/get-kafka-consumer-group-detail.md): Retrieves a consumer group's members and per-topic offset lag. Results are cached for two minutes (10 seconds on Managed Kafka clusters) unless forceRefresh is true. - [Change a Managed Kafka cluster's instance type](https://artie.com/docs/api-reference/kafka-clusters/change-a-managed-kafka-clusters-instance-type.md): Moves every broker of an active Managed Kafka cluster to another EC2 instance type and applies it. - [Get Kafka metrics graphs](https://artie.com/docs/api-reference/kafka-clusters/get-kafka-metrics-graphs.md): Retrieves broker, topic, partition, and per-broker CPU user/system metrics for a Strimzi Kafka cluster. - [Get Managed Kafka cluster rates](https://artie.com/docs/api-reference/kafka-clusters/get-managed-kafka-cluster-rates.md): Retrieves a Managed Kafka cluster's messages in and bytes out per second over the last 5 minutes, each topic's messages in per second now and over the last hour, and each consumer group's lag per topic over the range with its derived read rate. - [Rename a Kafka cluster](https://artie.com/docs/api-reference/kafka-clusters/rename-a-kafka-cluster.md): Changes the name a Managed Kafka cluster, or one on the company's BYOC data plane, shows in the dashboard. Its bootstrap address, Kubernetes objects, and MSK cluster keep the name it was created with. Company admins only. - [Restore a deleted Managed Kafka cluster](https://artie.com/docs/api-reference/kafka-clusters/restore-a-deleted-managed-kafka-cluster.md): Brings back a deleted Managed Kafka cluster with its data, address and passwords, until its data is deleted for good. Company admins only. - [Retry deploying a Managed Kafka cluster](https://artie.com/docs/api-reference/kafka-clusters/retry-deploying-a-managed-kafka-cluster.md): Deploys a Managed Kafka cluster again whose last deploy failed, or that has been deploying for over 20 minutes. Company admins only. - [Grow a Managed Kafka cluster's broker storage](https://artie.com/docs/api-reference/kafka-clusters/grow-a-managed-kafka-clusters-broker-storage.md): Grows the disk of every broker in an active Managed Kafka cluster and applies it. - [Change a Managed Kafka cluster's storage autoscaling](https://artie.com/docs/api-reference/kafka-clusters/change-a-managed-kafka-clusters-storage-autoscaling.md): Sets whether Artie grows the brokers' disks before they fill, at what % full, how full they are after, and the most disk per broker. Takes effect on the next autoscale run; nothing is applied to the cluster. Company admins only. - [Get Kafka storage graph](https://artie.com/docs/api-reference/kafka-clusters/get-kafka-storage-graph.md): Retrieves persistent-volume storage utilization for a Strimzi Kafka cluster. - [Get Kafka cluster summary](https://artie.com/docs/api-reference/kafka-clusters/get-kafka-cluster-summary.md): Retrieves cached topic and consumer group counts for the cluster unless forceRefresh is true. - [Change a Managed Kafka cluster's tiered storage settings](https://artie.com/docs/api-reference/kafka-clusters/change-a-managed-kafka-clusters-tiered-storage-settings.md): Changes whether every topic of an active Managed Kafka cluster is tiered, its days on disk and its disk cap per partition. - [Sync a Managed Kafka cluster's tiered storage now](https://artie.com/docs/api-reference/kafka-clusters/sync-a-managed-kafka-clusters-tiered-storage-now.md): Queues the sync that makes each topic of a Managed Kafka cluster match the tiered storage choice for it, which otherwise runs every 12 hours. A sync already running is left to finish. Active clusters only. Company admins only. - [Get Kafka topic partition sizes](https://artie.com/docs/api-reference/kafka-clusters/get-kafka-topic-partition-sizes.md): Retrieves cached, customer-safe partition sizes for every topic unless forceRefresh is true. - [List Kafka topics](https://artie.com/docs/api-reference/kafka-clusters/list-kafka-topics.md): Retrieves the light topic list for the cluster (no per-topic detail fetch). Results are cached for two minutes unless forceRefresh is true. Includes the owning source reader name and table name when the topic belongs to an Artie pipeline. - [Create a Kafka topic](https://artie.com/docs/api-reference/kafka-clusters/create-a-kafka-topic.md): Creates a topic. - [Delete a Kafka topic](https://artie.com/docs/api-reference/kafka-clusters/delete-a-kafka-topic.md): Deletes a topic and all of its messages. - [Get Kafka topic detail](https://artie.com/docs/api-reference/kafka-clusters/get-kafka-topic-detail.md): Retrieves topic metadata and partition sizes. Includes the owning source reader name, table name, and pipeline names and UUIDs when the topic belongs to an Artie pipeline. - [Change Kafka topic settings](https://artie.com/docs/api-reference/kafka-clusters/change-kafka-topic-settings.md): Changes a topic's retention and tiered storage; send only the settings to change. - [Get latest Kafka topic message](https://artie.com/docs/api-reference/kafka-clusters/get-latest-kafka-topic-message.md): Retrieves the newest message from partition 0, including its contents. Results are not cached. Only available when the company allows reading Kafka messages. - [Get newest Kafka topic messages](https://artie.com/docs/api-reference/kafka-clusters/get-newest-kafka-topic-messages.md): Retrieves the newest messages across all partitions of a Managed Kafka topic, newest first, including their contents. - [Increase Kafka topic partitions](https://artie.com/docs/api-reference/kafka-clusters/increase-kafka-topic-partitions.md): Increases a topic's partition count. - [Change Kafka topic retention](https://artie.com/docs/api-reference/kafka-clusters/change-kafka-topic-retention.md): Sets a topic's `retention.ms`. - [List Kafka users](https://artie.com/docs/api-reference/kafka-clusters/list-kafka-users.md): Retrieves the Kafka users for the cluster. Passwords are never included. - [Create a Kafka user](https://artie.com/docs/api-reference/kafka-clusters/create-a-kafka-user.md): Creates a Kafka user. - [Delete a Kafka user](https://artie.com/docs/api-reference/kafka-clusters/delete-a-kafka-user.md): Deletes the Kafka user. Kafka then revokes its credentials and ACLs, normally within seconds. Returns 204 once the user is deleted, or 200 with a warning while deletion is pending reconciliation. Admin-profile users are deleted under /admin-users. - [Get a Kafka user](https://artie.com/docs/api-reference/kafka-clusters/get-a-kafka-user.md): Retrieves a Kafka user. Its password is never included; get it from the credentials endpoint. Admin-profile users are not found here. - [Get Kafka user credentials](https://artie.com/docs/api-reference/kafka-clusters/get-kafka-user-credentials.md): Returns the Kafka user's password, which lets the caller act as that user, so kafka_users:read grants read access to all replicated data. - [Estimate a Managed Kafka cluster's monthly cost](https://artie.com/docs/api-reference/kafka-clusters/estimate-a-managed-kafka-clusters-monthly-cost.md): Prices a cluster and its usage in whole dollars from the stored AWS prices. Artie's fee is on compute only; tiered storage is billed uncompressed at the S3 price. - [List pipelines](https://artie.com/docs/api-reference/pipelines/list-pipelines.md): Returns pipelines for the authenticated company, optionally filtered by environment. - [Create a pipeline on an existing source reader](https://artie.com/docs/api-reference/pipelines/create-a-pipeline-on-an-existing-source-reader.md): Creates a pipeline attached to an existing source reader (pipeline.sourceReaderUUID). The reader must have no pipeline yet, or be shared. To start a new capture from a source connector, use POST /pipelines/create-from-source. - [Delete pipeline](https://artie.com/docs/api-reference/pipelines/delete-pipeline.md): Deletes a pipeline by UUID. - [Get pipeline configuration](https://artie.com/docs/api-reference/pipelines/get-pipeline-configuration.md): Returns FullPipeline for the pipeline uuid (tables with uuid/status, destinationUUID, specificDestCfg, sourceReaderUUID). MCP clients must omit includeRelatedObjects. The Dashboard UI may pass includeRelatedObjects=true to wrap sourceReader and connectors; that body is not the documented 200 schema. - [Update pipeline](https://artie.com/docs/api-reference/pipelines/update-pipeline.md): Full replace of an existing pipeline by UUID. Omitted fields are written as zero values: missing dataPlaneName 400s, missing tables deletes every table. Clients must echo the last FullPipeline and change only the intended fields. - [Trigger automatic schema changes](https://artie.com/docs/api-reference/pipelines/trigger-automatic-schema-changes.md): Enqueues automatic schema changes for one eligible pipeline. Set forceRefresh to bypass the two-hour cooldown for this execution. The request is accepted before reconciliation completes. - [Backfill pipeline tables](https://artie.com/docs/api-reference/pipelines/backfill-pipeline-tables.md): Triggers a backfill for specified tables in the pipeline. Supports options for pre-backfill behavior (drop, truncate, or do nothing) and schema/database filtering. - [Cancel backfill](https://artie.com/docs/api-reference/pipelines/cancel-backfill.md): Cancels backfilling for the given table UUIDs and/or history table UUIDs. - [Detect schema changes](https://artie.com/docs/api-reference/pipelines/detect-schema-changes.md): Enqueues a background job that checks the pipeline's source database for new, removed, or altered tables. If the pipeline has auto-replicate or auto-history mode enabled, any newly discovered tables will be added to the pipeline automatically. An email summary is sent if changes are detected. - [List pipeline error logs](https://artie.com/docs/api-reference/pipelines/list-pipeline-error-logs.md): Returns recent error logs for the specified pipeline (message, errorDetail, table/schema, timestamps). MCP clients pass the pipeline uuid only. - [Start pipeline](https://artie.com/docs/api-reference/pipelines/start-pipeline.md): Starts or resumes a pipeline. Fails if the pipeline has no destination, no tables, or (Postgres/Cockroach/Oracle) a source reader with an empty database. Optional body: keepPaused, disableBackFill. - [Update pipeline status](https://artie.com/docs/api-reference/pipelines/update-pipeline-status.md): Changes the status of a pipeline (e.g. - [Update pipeline with source reader](https://artie.com/docs/api-reference/pipelines/update-pipeline-with-source-reader.md): Updates pipeline and optionally its source reader in one request. Accepts gzip-encoded body. - [Get pipeline usage](https://artie.com/docs/api-reference/pipelines/get-pipeline-usage.md): Returns table-level usage statistics for the specified pipeline within a given time range. Requires 'from' and 'to' query parameters in RFC3339 format. Pass 'excludeBackfills=true' to exclude backfill rows from row counts. - [Create a new pipeline from a source](https://artie.com/docs/api-reference/pipelines/create-a-new-pipeline-from-a-source.md): Creates a draft pipeline and a dedicated source reader. - [Validate unsaved destination](https://artie.com/docs/api-reference/pipelines/validate-unsaved-destination.md): Validates destination configuration without persisting. Returns 204 on success or 200 with error message on validation failure. A destination that names a saved connector by uuid also needs connectors:write. - [Validate unsaved source](https://artie.com/docs/api-reference/pipelines/validate-unsaved-source.md): Validates source reader and connector configuration without persisting. Returns 204 on success or 200 with error message on validation failure. A sourceConnector that names a saved connector by uuid also needs connectors:write. - [Create a PrivateLink connection](https://artie.com/docs/api-reference/privatelink-connections/create-a-privatelink-connection.md): Creates a new PrivateLink connection for the authenticated company. - [Delete a PrivateLink connection](https://artie.com/docs/api-reference/privatelink-connections/delete-a-privatelink-connection.md): Permanently deletes a PrivateLink connection by UUID. This action cannot be undone and will remove the connection from your account. - [Get a PrivateLink connection](https://artie.com/docs/api-reference/privatelink-connections/get-a-privatelink-connection.md): Retrieves the details of a PrivateLink connection by UUID, including its status, cloud provider, region, Private Link target (vpcServiceName and availabilityZoneIds on AWS, privateLinkServiceAlias on Azure), and the Artie endpoint's address (dnsEntry: a DNS name on AWS, a private IP on Azure). - [Update a PrivateLink connection](https://artie.com/docs/api-reference/privatelink-connections/update-a-privatelink-connection.md): Updates an existing PrivateLink connection by UUID. - [List source readers](https://artie.com/docs/api-reference/source-readers/list-source-readers.md): Lists all source readers for the authenticated company. - [Create a source reader](https://artie.com/docs/api-reference/source-readers/create-a-source-reader.md): Creates a new source reader for the authenticated company. - [Delete a source reader](https://artie.com/docs/api-reference/source-readers/delete-a-source-reader.md): Permanently deletes a source reader by UUID. The source reader must not be associated with any active pipelines before deletion. - [Get a source reader](https://artie.com/docs/api-reference/source-readers/get-a-source-reader.md): Retrieves a source reader by UUID, including database, settings, and table configuration. Sensitive fields may be present. MCP clients should echo this payload into source_reader_update. - [Update a source reader](https://artie.com/docs/api-reference/source-readers/update-a-source-reader.md): Updates an existing source reader by UUID. Echo the last source_reader_detail payload and change only the intended fields; omitting name, database, or connectorUUID overwrites them with empty values. - [Deploy a source reader](https://artie.com/docs/api-reference/source-readers/deploy-a-source-reader.md): Deploys a shared source reader to the data plane. The source reader must be shared and pass validation before it can be deployed. - [Update source reader status](https://artie.com/docs/api-reference/source-readers/update-source-reader-status.md): Changes the status of a shared source reader (e.g. - [Validate an unsaved source reader](https://artie.com/docs/api-reference/source-readers/validate-an-unsaved-source-reader.md): Validates a source reader configuration without persisting it. - [Create an SSH tunnel](https://artie.com/docs/api-reference/ssh-tunnels/create-an-ssh-tunnel.md): Creates a new SSH tunnel for the authenticated company. - [Delete an SSH tunnel](https://artie.com/docs/api-reference/ssh-tunnels/delete-an-ssh-tunnel.md): Permanently deletes an SSH tunnel by UUID. The tunnel must not be in use by any connectors or pipelines before it can be deleted. - [Get an SSH tunnel](https://artie.com/docs/api-reference/ssh-tunnels/get-an-ssh-tunnel.md): Retrieves the details of an SSH tunnel by UUID, including its host, port, username, public key, and whether it is currently in use. - [Update an SSH tunnel](https://artie.com/docs/api-reference/ssh-tunnels/update-an-ssh-tunnel.md): Updates an existing SSH tunnel by UUID. You can modify the name, host, port, and username. Changes will mark associated pipelines as having undeployed changes. ## Webhook events - [Overview](https://artie.com/docs/api/webhooks/overview.md): Configure HTTPS webhooks to receive real-time notifications when events occur in your pipelines. - [replication.started](https://artie.com/docs/api/webhooks/replication-started.md): The replication process has started. - [replication.error](https://artie.com/docs/api/webhooks/replication-error.md): An error occurred during replication. - [row.skipped](https://artie.com/docs/api/webhooks/row-skipped.md): A row was not written due to size limits. - [ddl.seen](https://artie.com/docs/api/webhooks/ddl-seen.md): A DDL statement was detected in the CDC stream (MySQL only). - [ddl.applied](https://artie.com/docs/api/webhooks/ddl-applied.md): Artie has applied a schema change to the destination. - [backfill.started](https://artie.com/docs/api/webhooks/backfill-started.md): A backfill has started for a table. - [backfill.completed](https://artie.com/docs/api/webhooks/backfill-completed.md): A backfill has finished successfully. - [backfill.failed](https://artie.com/docs/api/webhooks/backfill-failed.md): A backfill failed before completing. - [dedupe.started](https://artie.com/docs/api/webhooks/dedupe-started.md): A deduplication job has started for a table. - [dedupe.completed](https://artie.com/docs/api/webhooks/dedupe-completed.md): A deduplication job has finished successfully. - [dedupe.failed](https://artie.com/docs/api/webhooks/dedupe-failed.md): A deduplication job failed. - [oom.killed](https://artie.com/docs/api/webhooks/oom-killed.md): A backfill pod ran out of memory. - [dek.generated](https://artie.com/docs/api/webhooks/dek-generated.md): A new Data Encryption Key (DEK) was generated. - [database.discovered](https://artie.com/docs/api-reference/databasediscovered.md): Database discovered. Artie doesn't send this event yet. - [database.removed](https://artie.com/docs/api-reference/databaseremoved.md): Database removed. Artie doesn't send this event yet. - [database.discovery_failed](https://artie.com/docs/api-reference/databasediscovery_failed.md): Database discovery failed. Artie doesn't send this event yet. - [replication.failed](https://artie.com/docs/api/webhooks/replication-failed.md): Deprecated alias for replication.error. - [connection.failed](https://artie.com/docs/api/webhooks/connection-failed.md): Deprecated alias for replication.error. ## MCP - [MCP server](https://artie.com/docs/api/mcp.md): Connect an MCP-compatible AI client to Artie to work with approved pipeline and infrastructure operations. - [MCP tools](https://artie.com/docs/api/mcp-tools.md): Browse every Artie operation exposed through the MCP server. - [Agent Skills](https://artie.com/docs/api/agent-skills.md): Give compatible AI coding agents Artie’s pipeline-setup guidance. ## Changelog - [Changelog](https://artie.com/docs/changelog.md): Stay up to date with the latest features, improvements, and bug fixes in Artie. ## OpenAPI specs - [Artie API (OpenAPI)](https://raw.githubusercontent.com/artie-labs/artie-api-spec/refs/heads/master/openapi.yaml) - [Events API (OpenAPI)](https://artie.com/docs/openapi.yaml)