Treasure Data Plazma Query Tool API

The PlazmaQueryTool API from Treasure Data — 2 operation(s) for plazmaquerytool.

Documentation GitHub OpenAPI

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /api/plazma_query_tools Create a Plazma query tool · create #

Ask an LLM

“Can I let an AI agent run queries against my Plazma data?”

“What does it take to create a Plazma query tool?”

Tell an agent

Create a Plazma query tool with {data}.

Add a new query tool over Plazma for my agents using {data}.

DELETE /api/plazma_query_tools/{id} Delete a Plazma query tool · destroy #

Ask an LLM

“How do I remove a Plazma query tool from my agents?”

“Is deleting a Plazma query tool permanent?”

Tell an agent destructive · confirm first

Delete Plazma query tool {id}.

Remove the unused Plazma query tool {id}.

GET /api/plazma_query_tools/{id} Get a Plazma query tool · show #

Ask an LLM

“How is a particular Plazma query tool set up?”

“Can I look up one Plazma query tool by ID?”

Tell an agent

Show Plazma query tool {id}.

Fetch the configuration of Plazma query tool {id}.

PATCH /api/plazma_query_tools/{id} Update a Plazma query tool · update #

Ask an LLM

“Can I change the settings of an existing Plazma query tool?”

“What can I edit on a Plazma query tool?”

Tell an agent

Update Plazma query tool {id} with {data}.

Edit the configuration of existing Plazma query tool {id}.

Documentation

📖

Documentation

https://docs.treasure.ai/apis/td-api

📖

APIReference

https://docs.treasure.ai/apis/td_api_v3-public

📖

GettingStarted

https://docs.treasure.ai/apis/td-api

📖

Documentation

https://docs.treasure.ai/apis/audience-api/overview

📖

APIReference

https://docs.treasure.ai/apis/td_cdp_api-public

📖

GettingStarted

https://docs.treasure.ai/apis/audience-api

📖

Documentation

https://docs.treasure.ai/apis/llm-api

📖

APIReference

https://docs.treasure.ai/apis/llm_api-public

📖

GettingStarted

https://docs.treasure.ai/apis/llm-api

📖

APIReference

https://docs.treasure.ai/apis/dwh_integration_api-public

📖

GettingStarted

https://docs.treasure.ai/apis/dwh-integration-api/quickstart

📖

GettingStarted

https://docs.treasure.ai/apis/p13n-api

📖

GettingStarted

https://docs.treasure.ai/apis/postback-v2/quickstart

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/treasure-data/refs/heads/main/openapi/treasure-data-plazmaquerytool-api-openapi.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/treasure-data:treasure-data-plazmaquerytool-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

openapi: 3.2.0
info:
  title: llm-api Plazma Query Tool API
  version: 1.0.0
servers:
- url: https://llm-api.treasuredata.com
- url: https://llm-api.eu01.treasuredata.com
- url: https://llm-api.ap02.treasuredata.com
- url: https://llm-api.treasuredata.co.jp
security:
- ApiKeyAuth: []
tags:
- name: PlazmaQueryTool
paths:
  /api/plazma_query_tools:
    post:
      summary: create
      tags:
      - PlazmaQueryTool
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                data:
                  type: object
                  properties:
                    type:
                      type: string
                    attributes:
                      type: object
                      properties:
                        projectId:
                          type: string
                        name:
                          type: string
                        maxRows:
                          type: integer
                        timeoutSeconds:
                          type: integer
                      required:
                      - projectId
                      - name
                  required:
                  - type
                  - attributes
              required:
              - data
            example:
              data:
                type: plazmaQueryTools
                attributes:
                  projectId: 00000000-0000-0000-0000-000000000001
                  name: Minimal Plazma Tool
                  maxRows: 75
                  timeoutSeconds: 120
      responses:
        '201':
          description: creates a new PlazmaQueryTool with minimal parameters (uses defaults)
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      type:
                        type: string
                      links:
                        type: object
                        properties:
                          self:
                            type: string
                        required:
                        - self
                      attributes:
                        type: object
                        properties:
                          createdAt:
                            type: string
                          updatedAt:
                            type: string
                          projectId:
                            type: string
                          name:
                            type: string
                          maxRows:
                            type: integer
                          timeoutSeconds:
                            type: integer
                          isManaged:
                            type: boolean
                        required:
                        - createdAt
                        - updatedAt
                        - projectId
                        - name
                        - maxRows
                        - timeoutSeconds
                        - isManaged
                    required:
                    - id
                    - type
                    - links
                    - attributes
                required:
                - data
              example:
                data:
                  id: 00000000-0000-0000-0000-000000000001
                  type: plazmaQueryTools
                  links:
                    self: http://www.example.com/api/plazma_query_tools/00000000-0000-0000-0000-000000000001
                  attributes:
                    createdAt: '2025-05-01T05:05:14.000Z'
                    updatedAt: '2025-05-01T05:05:14.000Z'
                    projectId: 00000000-0000-0000-0000-000000000001
                    name: Minimal Plazma Tool
                    maxRows: 50
                    timeoutSeconds: 60
                    isManaged: false
        '400':
          description: POST /api/plazma_query_tools rejects {"updatedAt":1}
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        title:
                          type: string
                        detail:
                          type: string
                        code:
                          type: string
                        status:
                          type: string
                      required:
                      - title
                      - detail
                      - code
                      - status
                required:
                - errors
              example:
                errors:
                - title: Param not allowed
                  detail: updatedAt is not allowed.
                  code: '105'
                  status: '400'
        '422':
          description: POST /api/plazma_query_tools rejects {"timeoutSeconds":60.5}
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        title:
                          type: string
                        detail:
                          type: string
                        code:
                          type: string
                        source:
                          type: object
                          properties:
                            pointer:
                              type: string
                          required:
                          - pointer
                        status:
                          type: string
                        meta:
                          type: object
                          properties:
                            validationCode:
                              type: string
                          required:
                          - validationCode
                      required:
                      - title
                      - detail
                      - code
                      - source
                      - status
                      - meta
                required:
                - errors
              example:
                errors:
                - title: must be an integer
                  detail: timeoutSeconds - must be an integer
                  code: '100'
                  source:
                    pointer: /data/attributes/timeoutSeconds
                  status: '422'
                  meta:
                    validationCode: NOT_AN_INTEGER
      operationId: postApiPlazmaQueryTools
      x-operation-id-source: derived
  /api/plazma_query_tools/{id}:
    delete:
      summary: destroy
      tags:
      - PlazmaQueryTool
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        example: 00000000-0000-0000-0000-000000000001
      responses:
        '204':
          description: deletes a PlazmaQueryTool
        '404':
          description: returns 404 when trying to delete non-existent PlazmaQueryTool
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        title:
                          type: string
                        detail:
                          type: string
                        code:
                          type: string
                        status:
                          type: string
                      required:
                      - title
                      - detail
                      - code
                      - status
                required:
                - errors
              example:
                errors:
                - title: Record not found
                  detail: The record identified by 00000000-0000-0000-0000-000000000001 could not be found.
                  code: '404'
                  status: '404'
      operationId: deleteApiPlazmaQueryToolsById
      x-operation-id-source: derived
    get:
      summary: show
      tags:
      - PlazmaQueryTool
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        example: 00000000-0000-0000-0000-000000000001
      responses:
        '200':
          description: retrieves a PlazmaQueryTool
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      type:
                        type: string
                      links:
                        type: object
                        properties:
                          self:
                            type: string
                        required:
                        - self
                      attributes:
                        type: object
                        properties:
                          createdAt:
                            type: string
                          updatedAt:
                            type: string
                          projectId:
                            type: string
                          name:
                            type: string
                          maxRows:
                            type: integer
                          timeoutSeconds:
                            type: integer
                          isManaged:
                            type: boolean
                        required:
                        - createdAt
                        - updatedAt
                        - projectId
                        - name
                        - maxRows
                        - timeoutSeconds
                        - isManaged
                    required:
                    - id
                    - type
                    - links
                    - attributes
                required:
                - data
              example:
                data:
                  id: 00000000-0000-0000-0000-000000000001
                  type: plazmaQueryTools
                  links:
                    self: http://www.example.com/api/plazma_query_tools/00000000-0000-0000-0000-000000000001
                  attributes:
                    createdAt: '2025-05-01T05:05:14.000Z'
                    updatedAt: '2025-05-01T05:05:14.000Z'
                    projectId: 00000000-0000-0000-0000-000000000001
                    name: TestPlazmaQuery
                    maxRows: 25
                    timeoutSeconds: 90
                    isManaged: false
        '404':
          description: returns 404 when PlazmaQueryTool doesn't exist
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        title:
                          type: string
                        detail:
                          type: string
                        code:
                          type: string
                        status:
                          type: string
                      required:
                      - title
                      - detail
                      - code
                      - status
                required:
                - errors
              example:
                errors:
                - title: Record not found
                  detail: The record identified by 00000000-0000-0000-0000-000000000001 could not be found.
                  code: '404'
                  status: '404'
      operationId: getApiPlazmaQueryToolsById
      x-operation-id-source: derived
    patch:
      summary: update
      tags:
      - PlazmaQueryTool
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        example: 00000000-0000-0000-0000-000000000001
      responses:
        '200':
          description: updates only specified fields
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      type:
                        type: string
                      links:
                        type: object
                        properties:
                          self:
                            type: string
                        required:
                        - self
                      attributes:
                        type: object
                        properties:
                          createdAt:
                            type: string
                          updatedAt:
                            type: string
                          projectId:
                            type: string
                          name:
                            type: string
                          maxRows:
                            type: integer
                          timeoutSeconds:
                            type: integer
                          isManaged:
                            type: boolean
                        required:
                        - createdAt
                        - updatedAt
                        - projectId
                        - name
                        - maxRows
                        - timeoutSeconds
                        - isManaged
                    required:
                    - id
                    - type
                    - links
                    - attributes
                required:
                - data
              example:
                data:
                  id: 00000000-0000-0000-0000-000000000001
                  type: plazmaQueryTools
                  links:
                    self: http://www.example.com/api/plazma_query_tools/00000000-0000-0000-0000-000000000001
                  attributes:
                    createdAt: '2025-05-01T05:05:14.000Z'
                    updatedAt: '2025-05-01T05:05:14.000Z'
                    projectId: 00000000-0000-0000-0000-000000000001
                    name: TestPlazma Query
                    maxRows: 10
                    timeoutSeconds: 90
                    isManaged: false
        '400':
          description: PATCH /api/plazma_query_tools rejects {"updatedAt":1}
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        title:
                          type: string
                        detail:
                          type: string
                        code:
                          type: string
                        status:
                          type: string
                      required:
                      - title
                      - detail
                      - code
                      - status
                required:
                - errors
              example:
                errors:
                - title: Param not allowed
                  detail: updatedAt is not allowed.
                  code: '105'
                  status: '400'
        '422':
          description: validates updated values
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        title:
                          type: string
                        detail:
                          type: string
                        code:
                          type: string
                        source:
                          type: object
                          properties:
                            pointer:
                              type: string
                          required:
                          - pointer
                        status:
                          type: string
                        meta:
                          type: object
                          properties:
                            validationCode:
                              type: string
                          required:
                          - validationCode
                      required:
                      - title
                      - detail
                      - code
                      - source
                      - status
                      - meta
                required:
                - errors
              example:
                errors:
                - title: must be in 1..100
                  detail: maxRows - must be in 1..100
                  code: '100'
                  source:
                    pointer: /data/attributes/maxRows
                  status: '422'
                  meta:
                    validationCode: INVALID_FORMAT_OR_ASSOCIATION
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                data:
                  type: object
                  properties:
                    type:
                      type: string
                    id:
                      type: string
                    attributes:
                      type: object
                      properties:
                        name:
                          type: string
                        maxRows:
                          type: integer
                        timeoutSeconds:
                          type: integer
                      required:
                      - maxRows
                  required:
                  - type
                  - id
                  - attributes
              required:
              - data
            example:
              data:
                type: plazmaQueryTools
                id: 00000000-0000-0000-0000-000000000001
                attributes:
                  name: Updated Plazma Query Tool
                  maxRows: 10
                  timeoutSeconds: 180
      operationId: patchApiPlazmaQueryToolsById
      x-operation-id-source: derived
components:
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: TD1