/api/agent

PUT /api/agent/v1/question/{id}

Changed on

Update a saved question (card). Patch semantics - only fields that you pass are changed.

Set collection_id to move the card to a different collection. Set archived: true to archive. Archiving is a soft delete - there is no delete endpoint. It can be reversed by setting archived: false. Pass query (a query_handle from construct_query or construct_native_query, or a base64 query string) to replace the underlying query. Replacing it with a native (raw SQL) query requires native-query permission on the target database.

put/api/agent/v1/question/{id}

Request

  • Base URL
    (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    API key in header X-API-Key

Path parameters

idinteger required

value must be an integer greater than zero.

Request body

archivedboolean nullable
collection_idinteger nullable

value must be an integer greater than zero.

descriptionstring nullable
display'table' | 'bar' | 'line' | 'pie' | 'scatter' | 'area' | 'row' | 'combo' | 'pivot' | 'scalar' | 'smartscalar' | 'gauge' | 'progress' | 'funnel' | 'map' | 'waterfall' | 'sankey'

Display types accepted by Card. Validates LLM-passed values so a bogus value (e.g. "potato") gets a 400 rather than persisting junk.

namestring nullable

value must be a non-blank string.

querystring nullable

value must be a non-blank string.

visualization_settingsobject nullable

Value must be a map.

Response

Successful response

archivedboolean required
collection_idinteger nullable required

value must be an integer greater than zero.

collection_pathstring required
descriptionstring nullable required
displaystring required
idinteger required

value must be an integer greater than zero.

namestring required

value must be a non-blank string.

Changes