Jump to Content
Home
Home
Guides
Recipes
API Reference
Python SDK
AI Agent SDK
Alation's MCP Server
v2023.1.5
v2023.1.6
v2023.1.7
v2023.3
v2023.3.2
v2023.3.3
v2023.3.4
v2023.3.5
v2024.1
v2024.1.1
v2024.1.2
v2024.1.3
v2024.1.4
v2024.1.5
v2024.3
v2024.3.1-ja
v2024.3.1
v2024.3.2
v2024.3.4
v2024.3.5
v2025.1
v2025.1.2
v2025.1.3
v2025.1.4
v2025.1.5
v2025.3
v2025.3.1
v2025.3.2
v2025.3.3
Home
Alation Help Center
API Reference
Alation Help Center
v2025.3.3
Home
Guides
Recipes
API Reference
Python SDK
AI Agent SDK
Alation's MCP Server
Create a new Chat
Search
JUMP TO
Token Authentication and Management API
Refresh & Access Token Overview
APIAccessToken
Creates a new API Access Token.
post
Revokes all the active API Access Tokens for the user.
post
Validates the given API Access Token.
post
RefreshToken
Creates a new RefreshToken for the user.
post
Regenerates a RefreshToken, invalidating the current token in request body.
post
Validate the given RefreshToken.
post
OAuth 2.0 APIs for Service Authorization
Overview (Service User Authorization)
Authorization and Verification
Obtain access JSON web token (JWT).
post
Introspect JSON Web Token (JWT)
post
Get JSON Web Key Set
get
OAuth 2.0 APIs for Managing Clients and User Authorization
Overview (User Authorization)
OAuth Authorization
Initiate the OAuth Authorization Code flow.
get
OAuth Token Management
Obtain access and refresh tokens.
post
OAuth Client Administration
Register a new OAuth client
post
Update OAuth client configuration
patch
Delete OAuth client
del
Rotate client secret
post
Aggregated Context API
Context
Get relevant context from the Alation catalog
get
Alation Agent API
Agent
Get a list of Agents
get
Create an Alation Agent
post
Retrieve the Agent connectivity endpoint
get
List available Debian Alation Agent installer versions
get
Download a specific Debian Alation Agent installer version
get
List available RHEL Alation Agent installer versions
get
Download a specific RHEL Alation Agent installer version
get
Delete an Alation Agent
del
Get an Alation Agent
get
Update an Alation Agent
patch
Resync an Alation Agent
post
Revoke the certificate of the Alation Agent
post
Sign a certificate for the Alation Agent
post
Authentication Service
List available Authentication Service addon versions
get
Download a specific Authentication Service addon version
get
Alation AI API
Alation AI API Overview
Assets
Download asset
get
Chats
Create a new Chat
post
Get a page of Chats
get
Update a Chat
patch
Get a page of a Chat's Messages
get
Add tags to a chat.
post
Get the expected Eval output of a Chat
get
Remove tags from a chat. This operation is idempotent, removing tags multiple times will be ignored.
post
Message the "Dashboard Search" Agent (streaming)
post
Message the "Dashboard Search" Agent (async)
post
Message the "Catalog Context Search" Agent (streaming)
post
Message the "Catalog Context Search" Agent (async)
post
Message the "Catalog Search" Agent (streaming)
post
Message the "Catalog Search" Agent (async)
post
Message the "Data Product Query" Agent (streaming)
post
Message the "Data Product Query" Agent (async)
post
Message the "Deep Research" Agent (streaming)
post
Message the "Chart Generation" Agent (streaming)
post
Message the "Deep Research" Agent (async)
post
Message the "Chart Generation" Agent (async)
post
Message the "Analytics Agent" Agent (streaming)
post
Message the "Analytics Agent" Agent (async)
post
Message the "Query" Agent (streaming)
post
Message the "Query" Agent (async)
post
Message an Agent (streaming)
post
Message the "Data Product Question Manager" Agent (streaming)
post
Message an Agent (async)
post
Message the "Data Product Question Manager" Agent (async)
post
Query the "Alation Context" tool (streaming)
post
Message the "Curation" Agent (streaming)
post
Query the "Alation Context" tool (async)
post
Message the "Curation" Agent (async)
post
Query the "Analyze Catalog Question" tool (streaming)
post
Query the "Analyze Catalog Question" tool (async)
post
Query the "BI Report Search" tool (streaming)
post
Query the "BI Report Search" tool (async)
post
Query the "Bulk Retrieval" tool (streaming)
post
Query the "Bulk Retrieval" tool (async)
post
Query the "SQL Execution" tool (streaming)
post
Query the "SQL Execution" tool (async)
post
Query the "Chart Generation" tool (streaming)
post
Query the "Chart Generation" tool (async)
post
Query the "Get Custom Fields Definitions" tool (streaming)
post
Query the "Delete SQL Evaluation Case" tool (streaming)
post
Query the "Get Custom Fields Definitions" tool (async)
post
Query the "Delete SQL Evaluation Case" tool (async)
post
Query the "Get Data Schema" tool (streaming)
post
Query the "Get Data Schema" tool (async)
post
Query the "Get Data Product Raw Specification" tool (streaming)
post
Query the "Chart Generation from Asset" tool (streaming)
post
Query the "Get Data Product Raw Specification" tool (async)
post
Query the "Chart Generation from Asset" tool (async)
post
Query the "Get Data Sources" tool (streaming)
post
Query the "Get Data Sources" tool (async)
post
Query the "Get Signature Creation Instructions" tool (streaming)
post
Query the "Get Signature Creation Instructions" tool (async)
post
Query the "List Assets" tool (streaming)
post
Query the "List Assets" tool (async)
post
Query the "List Available Data Products Pertaining to the query" tool (streaming)
post
Query the "List Available Data Products Pertaining to the query" tool (async)
post
Query the "Retrieve Asset" tool (streaming)
post
Query the "Retrieve Asset" tool (async)
post
Query the "Save Asset" tool (streaming)
post
Query the "Save Asset" tool (async)
post
Query the "Run SQL Evaluation" tool (streaming)
post
Query the "Get SQL Evaluation Case" tool (streaming)
post
Query the "Run SQL Evaluation" tool (async)
post
Query the "Get SQL Evaluation Case" tool (async)
post
Query the "Search Catalog" tool (streaming)
post
Query the "Get SQL Evaluation Set" tool (streaming)
post
Query the "Search Catalog" tool (async)
post
Query the "Get SQL Evaluation Set" tool (async)
post
Query the "Search Filter Fields" tool (streaming)
post
Query the "Search Filter Fields" tool (async)
post
Query the "Search Filter Values" tool (streaming)
post
Query the "Search Filter Values" tool (async)
post
Query the "Upload SQL Evaluation Set" tool (streaming)
post
Query the "Upload SQL Evaluation Set" tool (async)
post
Query the "Update SQL Evaluation Case" tool (streaming)
post
Query the "Update SQL Evaluation Case" tool (async)
post
Query the "Get a Catalog Object" tool (streaming)
post
Query the "Get a Catalog Object" tool (async)
post
Query the "Update a Catalog Object" tool (streaming)
post
Query the "Update a Catalog Object" tool (async)
post
Query the "Get Users" tool (streaming)
post
Query the "Get Users" tool (async)
post
Query the "Get Groups" tool (streaming)
post
Query the "Get Groups" tool (async)
post
Config
Get a page of Agent Configs
get
Create an Agent Config
post
Get an Agent Config
get
Update an Agent Config
patch
Delete an Agent Config
del
Get a default Agent Config
get
Publish an Agent as a Tool
post
Clone an Agent Config
post
Unpublish an Agent as a Tool
del
Clone a deep-research Agent Config
post
Get a page of Tool Configs
get
Get a Tool Config
get
Get a page of LLM Configs
get
Get an LLM Config
get
Data Product
Create data product
post
Get data product task
get
Update data product description
put
Initiate Revise Data Product Workflow
post
Get All Revise Data Product Results
get
Get Revise Data Product Result
get
Validate SQL
post
Extract metrics from SQL
post
Get data product metrics extraction task
get
Evaluation
Get a page of Eval Sets
get
Get an Eval Set
get
Update an Eval Set
patch
Delete an Eval Set
del
Create an Eval Set
post
Create Eval Cases
post
Create Eval Cases from JSON
post
Get an Eval Case
get
Update an Eval Case
patch
Delete an Eval Case
del
Run an Eval
post
Get results for an Eval run
get
Get a report for an Eval run
get
Delete the results of an Eval run
del
Get a CSV of an Eval run
get
Feedback
Create feedback
post
List feedback
get
Get single feedback
get
Update feedback
patch
Delete feedback
del
SQL Evaluation
Get a SQL Eval Set
get
Create SQL Eval Cases
post
Create SQL Eval Cases from CSV
post
Get a SQL Eval Case
get
Update SQL Eval Case
patch
Delete a SQL Eval Case
del
Run a SQL Eval
post
Get SQL Eval Results
get
Get SQL Eval Result
get
Delete SQL Eval Result
del
Get SQL Eval Result as CSV
get
Task
Get a Task
get
Articles API
Article Overview
Article
GET all articles
get
POST an article
post
DELETE an article
del
GET an article
get
UPDATE an article
put
Resurrect an article
post
BI Source API
BI Source (GBMv2) Overview
server
GET a list of BI Servers
get
Create a list of BI Servers
post
GET a BI Server
get
Update a BI Server
patch
Migrate curation data for a BI Server
post
folder
DELETE a set of folders from a specified BI Server
del
GET a list of folders from a specified BI Server
get
Create/Update a list of folder objects
post
DELETE a BI folder
del
GET a BI folder
get
Partially update a BI folder
patch
connection
DELETE a set of connections from a specified BI Server
del
GET a list of connections from a specified BI Server
get
Create/Update a list of connection objects
post
DELETE a set of connection columns from a specified BI Server
del
GET a set of connection columns from a specified BI Server
get
Create/Update a list of connection column objects
post
DELETE a connection column
del
GET a connection column
get
Partially update a connection column
patch
DELETE a connection
del
GET a connection
get
Partially update a connection
patch
report
DELETE a set of reports from a specified BI Server
del
GET a list of reports from a specified BI Server
get
Create/Update a list of report objects
post
DELETE a set of report columns from a specified BI Server
del
GET a set of report columns from a specified BI Server
get
Create/Update a list of report column objects
post
DELETE a Report column
del
GET a Report column
get
Partially update a Report column
patch
DELETE a Report
del
GET a Report
get
Partially update a Report
patch
datasource
DELETE a set of datasources from a specified BI Server
del
GET a set of datasources from a specified BI Server
get
Create/Update a list of Datasources
post
DELETE a set of datasource columns from a specified BI Server
del
GET a set of datasource columns from a specified BI Server
get
Create/Update a list of Datasource Columns
post
DELETE a Datasource column
del
GET a Datasource column
get
Partially update a Datasource column
patch
DELETE a Datasource
del
GET a Datasource
get
Partially update a Datasource
patch
permission
DELETE a set of BI permissions from a specified BI server
del
GET a list of BI permissions from a specified BI Server
get
Create/Update a list of BI Permissions
post
DELETE a BI permission
del
GET a BI permission
get
images
DELETE the current image associated to this object using imagetype query
del
GET an image associated with a BI object from a BI Server
get
POST an image associated with a BI object from a BI Server
post
user
DELETE a set of BI users from a specified BI Server
del
GET a list of BI users from a specified BI Server
get
Create/Update a list of BI users
post
DELETE a BI user
del
GET a BI user
get
Connectors API (OCF)
connectors
Get a list of connectors
get
Conversations API
Conversations
Get a list of conversations
get
Create a conversation
post
Delete a conversation
del
Get a conversation by ID
get
Update a conversation
patch
Posts
Get a list of conversation posts
get
Create a conversation post
post
Delete a conversation post
del
Get a conversation post by ID
get
Update a conversation post
patch
Conversations API version 2
Conversations v2 Overview
Conversations
Get a list of conversations
get
Create a conversation
post
Delete a conversation
del
Get a conversation by ID
get
Update a conversation
patch
Assignees
Remove all assignees from a conversation with given ID
del
Get a list of assignees for a conversation with given ID
get
Remove a conversation assignee by ID
del
Get a conversation assignee by ID
get
Add one assignee to the conversation
post
Posts
Get a list of conversation posts
get
Create a conversation post
post
Delete a conversation post
del
Get a conversation post by ID
get
Update a conversation post
patch
Custom Fields API
Custom Field Overview
Custom Field
Bulk Read Custom Fields
get
Bulk Create Custom Fields
post
Read a Builtin Custom Field
get
Read a Custom Field
get
Custom Field Values API
Custom Field Values Overview
Custom Field Value
GET multiple Custom Field Values
get
PUT multiple Custom Field Values
put
PUT multiple Custom Field Values Async
put
Data Dictionary API
Data Dictionary
Get data dictionary task details
get
Get data dictionary task errors
get
Upload a data dictionary
put
Data Health API
Data Health Ingestion
Upsert rules and data health values
post
Data Health Deletion
Delete rules and data health values
del
Data Health Retrieval
Retrieve information about data quality fields
get
Retrieve information about data quality values
get
Data Products API
Data Products
Get all data products
get
Create a data product
post
Update a data product
put
Get a specific data product
get
Delete a data product
del
Get data product reports
get
Log report results on a data product
post
Get report results
get
Log report results on multiple data products
post
Data Product Versions
Get data product version
get
Update a data product version status
put
Delete a data product version
del
Data Marketplaces
Get all data marketplaces
get
Create a data marketplace
post
Update a data marketplace
put
Get a specific data marketplace
get
Delete a data marketplace
del
Data Products Publishing
Get data products in a marketplace
get
Get a specific data product in a marketplace
get
Publish a data product in a marketplace
post
Update a published data product in a marketplace
put
Unpublish a data product from a marketplace
del
Update data products in a marketplace
post
Check a data product against standards
post
Data Products Search
Search for data products in a marketplace
post
Permissions
Get permissions (admin only)
get
Add permission (admin only)
post
Update permission (admin only)
put
Delete permission (admin only)
del
Get all permissions assigned to the authenticated user
get
Native Data Quality API
Monitors
Create a new monitor
post
Retrieve monitors
get
Update existing monitors
put
Delete monitors
del
Trigger a monitor run
post
Datasources API
Native Data Sources API Overview
datasource
Get a list of datasources
get
Create a datasource
post
Delete a datasource
del
Get a datasource
get
Update a datasource
put
datasource config checks
Verify configuration checks
get
Verify network connection status
get
Verify service account authentication status
get
Verify service account privileges
get
datasource metadata extraction
Get a list of available schemas
get
Trigger metadata extraction job
post
Get metadata extraction configurations
get
Update metadata extraction configurations
patch
Update metadata extraction configurations
put
migrate native connector data sources to OCF
Bulk migrate data sources to OCF
post
Get a list of available ocf connectors and their native datasources
get
migrate data source to Agent connector
Migrate a data source to Agent
put
Data Sources API (OCF)
datasource
Get a list of datasources
get
Create a datasource
post
Delete a datasource
del
Get a datasource
get
Update an OCF datasource
put
datasource metadata extraction
Get a list of available schemas
get
Trigger metadata extraction job
post
Trigger job to sync schemas from data source
post
Get metadata extraction configurations
get
Update metadata extraction configurations
patch
datasource configuration
Get General Configuration for Datasource
get
Update general settings configuration including vault settings
patch
datasource config checks
Verify configuration checks
get
Verify network connection status
get
Verify service account authentication status
get
Verify service account privileges
get
Documents API
Documents
Delete documents
del
Retrieve documents
get
Create documents
post
Update documents
put
Domain API
Domain
Deletes the requested domain(s) and their subdomains. Additionally, it un-assigns all the objects from these domains and subdomains.
del
Retrieve a list of domains.
get
Create domains in bulk.
post
Retrieve a domain's details
get
Move a domain
patch
Adds the requested objects to a domain.
post
It allows user to browse the domain rules, with some filters.
post
Folder API
Folders
Delete folders
del
Retrieve folders
get
Create folders
post
Update folders
put
Groups API
Group Overview
Group
GET multiple Groups
get
GET a Group
get
Homepage Preferences API
Homepage Preferences
Update group homepage preferences
put
Lineage API v2
Lineage & Dataflows Overview
Dataflow
Delete a list of Dataflow objects
del
Get Dataflow object details and related paths
get
Update a list of Dataflow objects
patch
Create/Replace a list of Dataflow objects with lineage infomation
post
Lineage
Delete lineage information
del
Get lineage information
get
Post lineage information
post
Cross-System Lineage
Delete cross-system lineage records
del
Get cross-system lineage records
get
Create cross-system lineage records
post
Update cross-system lineage records
put
Delete cross-system lineage record
del
Get cross-system lineage record
get
Update cross-system lineage record
put
Lineage API v3
Lineage
Delete lineage (beta)
del
Logging API
Logging
Prepare Audit logs for download
post
Download prepared Audit logs
get
My Domains API
My Domains
Associate users and groups to domains
put
Members Permission API
Members Permission
Add members to a resource.
post
Replace members of a resource.
put
Remove members from a resource.
del
NoSQL API v2
NoSQL
Delete NoSQL data objects
del
Retrieve NoSQL data
get
Update NoSQL data objects
patch
Create NoSQL metadata
post
Otypes API
Otypes Overview
otype
GET a response from the otypes API endpoint
get
Policy API
Policies
Delete Policies in bulk
del
List Policies
get
Create Policies in bulk
post
Update Policies in bulk
put
Policy Groups
List Policy Groups
get
Privacy Settings API
Resource Privacy Settings
Manage resource privacy settings
patch
Relational Integration API
Relational Integration API Overview
Schema
Get schemas along with its custom fields
get
Create new schemas under a particular data source
post
Update schemas under a particular data source
patch
Table
Get tables along with its custom fields
get
Create new tables under a particular data source
post
Update tables under a particular data source
patch
Column
Get columns along with its custom fields
get
Create new columns under a particular data source
post
Update columns under a particular data source
patch
Child columns
Update children of root columns
patch
Fetch children for column
get
Update children of a sub-column
patch
Joins
Get joins by column (attribute) ID
get
Get joins by table ID
get
Get joins by column (attribute) name
get
Get joins by table name
get
Get joins by data source
get
SCIM 2.0 API
Authorization and Integration
Create SCIM Token
post
Search API
Search Overview
Search
GET a response from the search API endpoint
get
Synonyms
Retrieves synonym manifest
get
Clears current synonym manifest
del
Replaces current synonym manifest
post
Terms API
Terms
Delete terms
del
Retrieve terms
get
Create terms
post
Update terms
put
Template Visual Config API
Visual Config
Create a new visual config
post
List all visual configs
get
Get a specific visual config
get
Update an existing visual config
put
Delete a visual config
del
Get a list of visual configs per object type
get
User Public API
User Overview
User
GET multiple Users
get
GET a User
get
User API v2
User
GET multiple Users
get
GET a User
get
Workflows API
Workflows
List workflows
get
Requests
List requests
get
Create a request
post
Show request details
get
Review requests
List my review todos
get
Approve a review request
put
Reject a review request
put
Admin ✦
Table Metadata Sync Trigger
API Resources ✦
API Resources
Custom Fields (Legacy) ✦
Find Objects by Custom Field
Custom Template ✦
Custom Template
Flags and Tags ✦
Trust Check Flags API
Tags API
Jobs ✦
Jobs API
Metadata ✦
Relational Get APIs
Get Data Sources
Get Schemas
Relational Integration v1
NoSQL API ✦
NoSQL API v1 (Legacy)
Open With ✦
Open With (DataOS)
Alation Data Explorer
Open-With Registration
Query ✦
Queries API
Queriers APIs
Query Log Upload API
Upload Logical Metadata API ✦
ULM Overview
ULM with Article ID
Virtual Systems ✦
Virtual File System APIs
Virtual Data Source
Virtual BI Server
Powered by
Create a new Chat
post
{protocol}://{base-url}/ai/api/v1/chats
Create a new Chat.
Language
Shell
Node
Ruby
PHP
Python
Credentials
Cookie
URL
Base URL
https
://
alation_domain
/ai/api/v1
/chats
