Acceldata

Acceldata Asset UDF Variables API

The Asset UDF Variables API from Acceldata — 2 operation(s) for asset udf variables.

GitHub OpenAPI

Operations 5

POST /catalog-server/api/assets/{id}/udf-variables Create a UDF variable for an asset #
GET /catalog-server/api/assets/{id}/udf-variables List UDF variables for an asset #
PUT /catalog-server/api/assets/{id}/udf-variables/{variableId} Update a UDF variable for an asset #
DELETE /catalog-server/api/assets/{id}/udf-variables/{variableId} Delete a UDF variable from an asset #
GET /catalog-server/api/assets/{id}/udf-variables/{variableId} Get a specific UDF variable for an asset #

Documentation

📖
Documentation
https://docs.acceldata.io/api/introduction
📖
APIReference
https://documentation.acceldata.io/docs/acceldata/api/catalog
📖
Authentication
https://docs.acceldata.io/api/authentication
📖
Documentation
https://docs.acceldata.io/documentation/roles-and-permissions
📖
APIReference
https://documentation.acceldata.io/docs/acceldata/api/administration
📖
Authentication
https://docs.acceldata.io/documentation/api-keys
📖
Documentation
https://docs.acceldata.io/documentation/unified-tags
📖
APIReference
https://documentation.acceldata.io/docs/acceldata/api/tags

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/acceldata/refs/heads/main/openapi/acceldata-asset-udf-variables-api-openapi.yml

Other Resources

🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/acceldata/refs/heads/main/data-model/acceldata-data-model.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/acceldata/refs/heads/main/errors/acceldata-problem-types.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/acceldata/refs/heads/main/conventions/acceldata-conventions.yml
🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/acceldata/refs/heads/main/scopes/acceldata-scopes.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/acceldata-asset-udf-variables-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

acceldata-asset-udf-variables-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Catalog Asset UDF Variables API
  version: '1.0'
  description: API for managing the ADOC data catalog, including assets, asset metadata, tags, labels, sampling, lineage, and watched assets, as well as data reliability policies (data quality, reconciliation, data drift, schema drift, and related rule types) and their executions. Covers discovering and searching assets, retrieving asset configuration and activity, and creating, scheduling, and running policies against catalog assets.
tags:
- name: Asset UDF Variables
paths:
  /catalog-server/api/assets/{id}/udf-variables:
    post:
      operationId: createAssetUdfVariable
      tags:
      - Asset UDF Variables
      summary: Create a UDF variable for an asset
      description: 'This endpoint makes an HTTP POST request to create a user-defined field (UDF) variable for a specific asset.


        **Authorization**: requires `ASSET_VIEW` and `USER_DEFINED_FUNCTION_CREATE` (feature permission).


        #### Request Body


        - `assetId` (number, optional): The ID of the asset (path `id` sets scope when omitted).

        - `key` (string): The key or name of the UDF variable.

        - `value` (string): The value associated with the UDF variable.


        Schema: `AssetUDFVariableRequest`.


        #### Response Body


        The response body contains the created `AssetUDFVariable` record.'
      parameters:
      - name: id
        in: path
        description: Asset ID
        required: true
        schema:
          type: integer
      - name: accessKey
        in: header
        description: API access key generated from ADOC UI
        required: true
        schema:
          type: string
      - name: secretKey
        in: header
        description: API secret key generated from ADOC UI
        required: true
        schema:
          type: string
      - name: Accept
        in: header
        description: Always set to application/json
        required: true
        schema:
          type: string
      - name: Content-Type
        in: header
        description: Always set to application/json
        required: true
        schema:
          type: string
      requestBody:
        description: 'UDF variable definition (key, value; assetId optional). Schema: `AssetUDFVariableRequest`.'
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AssetUDFVariableRequest'
      responses:
        '200':
          description: Created UDF variable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetUDFVariable'
        '422':
          description: 'Could not create Asset Udf Variable : {message}'
    get:
      operationId: getAssetUdfVariables
      tags:
      - Asset UDF Variables
      summary: List UDF variables for an asset
      description: 'This endpoint retrieves the user-defined variables for a specific asset.


        **Authorization**: requires `ASSET_VIEW` and `USER_DEFINED_FUNCTION_VIEW` (feature permission).


        ### Response


        Returns `AssetUDFVariableResponse` containing all UDF variables scoped to the asset.'
      parameters:
      - name: id
        in: path
        description: Asset ID
        required: true
        schema:
          type: integer
      - name: accessKey
        in: header
        description: API access key generated from ADOC UI
        required: true
        schema:
          type: string
      - name: secretKey
        in: header
        description: API secret key generated from ADOC UI
        required: true
        schema:
          type: string
      - name: Accept
        in: header
        description: Always set to application/json
        required: true
        schema:
          type: string
      responses:
        '200':
          description: List of UDF variables
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetUDFVariableResponse'
        '422':
          description: 'Could not fetch Asset Udf Variables: {message}'
  /catalog-server/api/assets/{id}/udf-variables/{variableId}:
    put:
      operationId: updateAssetUdfVariable
      tags:
      - Asset UDF Variables
      summary: Update a UDF variable for an asset
      description: 'This endpoint allows the user to update a specific user-defined field variable for a particular asset.


        **Authorization**: requires `ASSET_VIEW` and `USER_DEFINED_FUNCTION_MODIFY` (feature permission).


        #### Request Body


        - `key` (string, optional): The key of the user-defined field variable.

        - `value` (string, optional): The value of the user-defined field variable.


        Schema: `AssetUDFVariableRequest`.


        #### Response


        Returns the updated `AssetUDFVariable`.'
      parameters:
      - name: id
        in: path
        description: Asset ID
        required: true
        schema:
          type: integer
      - name: variableId
        in: path
        description: Variable ID
        required: true
        schema:
          type: integer
      - name: accessKey
        in: header
        description: API access key generated from ADOC UI
        required: true
        schema:
          type: string
      - name: secretKey
        in: header
        description: API secret key generated from ADOC UI
        required: true
        schema:
          type: string
      - name: Accept
        in: header
        description: Always set to application/json
        required: true
        schema:
          type: string
      - name: Content-Type
        in: header
        description: Always set to application/json
        required: true
        schema:
          type: string
      requestBody:
        description: 'Updated UDF variable definition. Schema: `AssetUDFVariableRequest`.'
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AssetUDFVariableRequest'
      responses:
        '200':
          description: Updated UDF variable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetUDFVariable'
        '404':
          description: Asset Udf Variable {variableId} not found
        '422':
          description: 'Could not update Asset Udf Variable: {message}'
    delete:
      operationId: deleteAssetUdfVariable
      tags:
      - Asset UDF Variables
      summary: Delete a UDF variable from an asset
      description: 'This endpoint deletes a specific user-defined function (UDF) variable for a particular asset by its `variableId`.


        **Authorization**: requires `ASSET_VIEW` and `USER_DEFINED_FUNCTION_MODIFY` (feature permission).'
      parameters:
      - name: id
        in: path
        description: Asset ID
        required: true
        schema:
          type: integer
      - name: variableId
        in: path
        description: Variable ID
        required: true
        schema:
          type: integer
      - name: accessKey
        in: header
        description: API access key generated from ADOC UI
        required: true
        schema:
          type: string
      - name: secretKey
        in: header
        description: API secret key generated from ADOC UI
        required: true
        schema:
          type: string
      - name: Accept
        in: header
        description: Always set to application/json
        required: true
        schema:
          type: string
      responses:
        '204':
          description: UDF variable deleted successfully
        '404':
          description: Asset UDF variable with id {variableId} not found
    get:
      operationId: getAssetUdfVariable
      tags:
      - Asset UDF Variables
      summary: Get a specific UDF variable for an asset
      description: 'This endpoint retrieves user-defined variables for a specific asset using the asset `ID` and `variableId` with this endpoint.


        **Authorization**: requires `ASSET_VIEW` and `USER_DEFINED_FUNCTION_VIEW` (feature permission).


        ### Response


        Returns `AssetUDFVariable` with the variable key, value, and identifiers.'
      parameters:
      - name: id
        in: path
        description: Asset ID
        required: true
        schema:
          type: integer
      - name: variableId
        in: path
        description: Variable ID
        required: true
        schema:
          type: integer
      - name: accessKey
        in: header
        description: API access key generated from ADOC UI
        required: true
        schema:
          type: string
      - name: secretKey
        in: header
        description: API secret key generated from ADOC UI
        required: true
        schema:
          type: string
      - name: Accept
        in: header
        description: Always set to application/json
        required: true
        schema:
          type: string
      responses:
        '200':
          description: UDF variable details
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AssetUDFVariable'
        '404':
          description: Asset Udf Variable {variableId} not found
        '422':
          description: 'Could not fetch Asset Udf Variable: {message}'
components:
  schemas:
    AssetUDFVariableResponse:
      type: object
      title: io.ad.catalog.api.model.AssetUDFVariableResponse
      required:
      - assetId
      - variables
      properties:
        assetId:
          type: integer
        variables:
          type: array
          items:
            $ref: '#/components/schemas/AssetUDFVariableChild'
    AssetUDFVariableChild:
      type: object
      title: io.ad.catalog.api.model.AssetUDFVariableChild
      required:
      - id
      - key
      - value
      properties:
        id:
          type: integer
        key:
          type: string
        value:
          type: string
    AssetUDFVariableRequest:
      type: object
      title: io.ad.catalog.api.model.AssetUDFVariableRequest
      required:
      - key
      - value
      properties:
        assetId:
          type: integer
        key:
          type: string
        uid:
          type:
          - string
          - 'null'
        value:
          type: string
    DateTime:
      type: object
      title: org.joda.time.DateTime
    AssetUDFVariable:
      type: object
      title: io.ad.catalog.api.model.AssetUDFVariable
      required:
      - assetId
      - createdAt
      - id
      - key
      - updatedAt
      - value
      properties:
        assetId:
          type: integer
        createdAt:
          $ref: '#/components/schemas/DateTime'
        id:
          type: integer
        key:
          type: string
        updatedAt:
          $ref: '#/components/schemas/DateTime'
        value:
          type: string