Generate Metadata Keywords
POST
/ai/metadata/keywords/
const url = 'https://example.com/api/ai/metadata/keywords/';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"dataset_id":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.com/api/ai/metadata/keywords/ \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "dataset_id": "example" }'Generate AI-suggested keywords for a dataset.
Authorizations
Section titled “Authorizations ”Request Body required
Section titled “Request Body required ” Media type application/json
MetadataAssistRequest
Request body for metadata AI endpoints.
object
dataset_id
required
Dataset Id
UUID of the dataset to generate metadata for
string
Example generated
{ "dataset_id": "example"}Responses
Section titled “ Responses ”Successful Response
Media type application/json
KeywordSuggestionsResponse
AI-suggested keywords for a dataset.
object
keywords
required
Keywords
List of suggested keywords with classification (5-10 items)
Array<object>
KeywordSuggestionA single keyword suggestion with classification.
object
keyword
required
Keyword
Lowercase keyword
string
keyword_type
required
Keyword Type
Classification: theme, place, or temporal
string
Example generated
{ "keywords": [ { "keyword": "example", "keyword_type": "example" } ]}Bad request — invalid query parameters or payload
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Unauthorized — missing or invalid credentials
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Forbidden — caller lacks access to this resource
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Not found
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Validation error
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}Internal server error
ProblemDetail
object
type
Type
string
title
required
Title
string
status
required
Status
integer
detail
required
Detail
string
Example
{ "type": "about:blank"}