Server
/api/v1.0/
https://query-qa.adara.com/api/v1.0/
https://query-prod.adara.com/api/v1.0/
Server Variables
oauth2 oauth2

FlowClient Credentials
Token URL/core/v1.0/oauth/token

Get complete query details from the registry

Auth
Required Scopes:get:queries
Path Params
idstring
GET /queries/{id}
Responses
200

Successfully returned complete query details

objectobject
404

Failed to fetch complete query details since it was not found in the registry

Response

Update an existing query in the registry

Auth
Required Scopes:put:queries
Path Params
idstring
Request Body
objectobject

complete details of the query

summarystring

summary for an audience that helps understanding what it does

descriptionstring

detailed description that helps understanding the results to expect

querystring

sql query statement

parametersarray[object]

list of dictionary objects referred in the query statement

namestring

name of the parameter

typestring

Valid BQ data type of the parameter

Enum: INT64,NUMERIC,FLOAT64,BOOL,STRING,BYTES,DATE,DATETIME,GEOGRAPHY,TIME,TIMESTAMP

PUT /queries/{id}
Responses
200

Successfully updated the query in the registry

objectobject
404

Failed to update the query since it was not found in the registry

Response

De-activate a query in the registry

Auth
Required Scopes:delete:queries
Path Params
idstring
DELETE /queries/{id}
Responses
200

Successfully de-activated the query in the registry

objectobject
404

Failed to de-activate the query since it was not found in the registry

Response

Get the paginated list of details of all the queries stored in the registry

Auth
Required Scopes:get:queries
Query String
pageinteger

Default: 1

GET /queries
Responses
200

Successfully returned the paginated list of details of all the queries stored in the registry

objectobject
400

Failed to fetch the paginated list of details of all the queries stored in the registry

Response

Add a new query to the registry

Auth
Required Scopes:post:queries
Request Body
objectobject

complete details of the query

summarystring

summary for an audience that helps understanding what it does

descriptionstring

detailed description that helps understanding the results to expect

querystring

sql query statement

parametersarray[object]

list of dictionary objects referred in the query statement

namestring

name of the parameter

typestring

Valid BQ data type of the parameter

Enum: INT64,NUMERIC,FLOAT64,BOOL,STRING,BYTES,DATE,DATETIME,GEOGRAPHY,TIME,TIMESTAMP

POST /queries
Responses
200

Successfully added query to the registry

objectobject
400

Failed to add query to the registry

Response

Run

Execute a query segment from the registry

Auth
Required Scopes:post:run
Query String
idstring
trace_idstring
Request Body
objectobject
parametersobject

Parameter values referred in the query statement

POST /run
Responses
200

job id for the query execeution request is returned

objectobject
Response