model_api_keys

Creates, updates, deletes, gets or lists a model_api_keys resource.

Overview

Name	model_api_keys
Type	Resource
Id	digitalocean.genai.model_api_keys

Fields

The following fields are returned by SELECT queries:

genai_list_model_api_keys

A successful response.

Name	Datatype	Description
api_key_infos	array	Api key infos
links	object	Links to other pages
meta	object	Meta information about the data set

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
genai_list_model_api_keys	select		page, per_page	To list all model API keys, send a GET request to /v2/gen-ai/models/api_keys.
genai_create_model_api_key	insert			To create a model API key, send a POST request to /v2/gen-ai/models/api_keys.
genai_update_model_api_key	replace	api_key_uuid		To update a model API key, send a PUT request to /v2/gen-ai/models/api_keys/{api_key_uuid}.
genai_delete_model_api_key	delete	api_key_uuid		To delete an API key for a model, send a DELETE request to /v2/gen-ai/models/api_keys/{api_key_uuid}.
genai_regenerate_model_api_key	exec	api_key_uuid		To regenerate a model API key, send a PUT request to /v2/gen-ai/models/api_keys/{api_key_uuid}/regenerate.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
api_key_uuid	string	API key ID (example: "123e4567-e89b-12d3-a456-426614174000")
page	integer	Page number. (example: 1)
per_page	integer	Items per page. (example: 1)

SELECT examples

genai_list_model_api_keys

To list all model API keys, send a GET request to /v2/gen-ai/models/api_keys.

SELECT
api_key_infos,
links,
meta
FROM digitalocean.genai.model_api_keys
WHERE page = '{{ page }}'
AND per_page = '{{ per_page }}';

INSERT examples

genai_create_model_api_key

To create a model API key, send a POST request to /v2/gen-ai/models/api_keys.

INSERT INTO digitalocean.genai.model_api_keys (
data__name
)
SELECT 
'{{ name }}'
RETURNING
api_key_info
;

Manifest

# Description fields are for documentation purposes
- name: model_api_keys
  props:
    - name: name
      value: string
      description: >
        A human friendly name to identify the key
        

REPLACE examples

genai_update_model_api_key

To update a model API key, send a PUT request to /v2/gen-ai/models/api_keys/{api_key_uuid}.

REPLACE digitalocean.genai.model_api_keys
SET 
data__api_key_uuid = '{{ api_key_uuid }}',
data__name = '{{ name }}'
WHERE 
api_key_uuid = '{{ api_key_uuid }}' --required
RETURNING
api_key_info;

DELETE examples

genai_delete_model_api_key

To delete an API key for a model, send a DELETE request to /v2/gen-ai/models/api_keys/{api_key_uuid}.

DELETE FROM digitalocean.genai.model_api_keys
WHERE api_key_uuid = '{{ api_key_uuid }}' --required;

Lifecycle Methods

genai_regenerate_model_api_key

To regenerate a model API key, send a PUT request to /v2/gen-ai/models/api_keys/{api_key_uuid}/regenerate.

EXEC digitalocean.genai.model_api_keys.genai_regenerate_model_api_key 
@api_key_uuid='{{ api_key_uuid }}' --required;