Skip to content
DigitalOcean Gradient™ AI Agentic Cloud SDK Docs
  • Auto
  • Light
  • Dark

Update

API Reference
Agents
Evaluation Metrics
OpenAI
Keys
Update OpenAI API Key
put/v2/gen-ai/openai/keys/{api_key_uuid}

To update an OpenAI API key, send a PUT request to /v2/gen-ai/openai/keys/{api_key_uuid}.

Path ParametersExpand Collapse
api_key_uuid: string
Body ParametersExpand Collapse
api_key: optional string

OpenAI API key

api_key_uuid: optional string

API key ID

name: optional string

Name of the key

ReturnsExpand Collapse
api_key_info: optional APIOpenAIAPIKeyInfo { created_at, created_by, deleted_at, 4 more }

OpenAI API Key Info

created_at: optional string

Key creation date

formatdate-time
created_by: optional string

Created by user id from DO

formatuint64
deleted_at: optional string

Key deleted date

formatdate-time
models: optional array of APIAgentModel { agreement, created_at, inference_name, 12 more }

Models supported by the openAI api key

agreement: optional APIAgreement { description, name, url, uuid }

Agreement Description

description: optional string
name: optional string
url: optional string
uuid: optional string
created_at: optional string

Creation date / time

formatdate-time
inference_name: optional string

Internally used name

inference_version: optional string

Internally used version

is_foundational: optional boolean

True if it is a foundational model provided by do

metadata: optional unknown

Additional meta data

name: optional string

Name of the model

parent_uuid: optional string

Unique id of the model, this model is based on

provider: optional "MODEL_PROVIDER_DIGITALOCEAN" or "MODEL_PROVIDER_ANTHROPIC" or "MODEL_PROVIDER_OPENAI"
Accepts one of the following:
"MODEL_PROVIDER_DIGITALOCEAN"
"MODEL_PROVIDER_ANTHROPIC"
"MODEL_PROVIDER_OPENAI"
updated_at: optional string

Last modified

formatdate-time
upload_complete: optional boolean

Model has been fully uploaded

url: optional string

Download url

usecases: optional array of "MODEL_USECASE_UNKNOWN" or "MODEL_USECASE_AGENT" or "MODEL_USECASE_FINETUNED" or 4 more

Usecases of the model

Accepts one of the following:
"MODEL_USECASE_UNKNOWN"
"MODEL_USECASE_AGENT"
"MODEL_USECASE_FINETUNED"
"MODEL_USECASE_KNOWLEDGEBASE"
"MODEL_USECASE_GUARDRAIL"
"MODEL_USECASE_REASONING"
"MODEL_USECASE_SERVERLESS"
uuid: optional string

Unique id

version: optional APIModelVersion { major, minor, patch }

Version Information about a Model

major: optional number

Major version number

formatint64
minor: optional number

Minor version number

formatint64
patch: optional number

Patch version number

formatint64
name: optional string

Name

updated_at: optional string

Key last updated date

formatdate-time
uuid: optional string

Uuid

Update OpenAI API Key
  • http
  • typescript
  • python
curl https://api.digitalocean.com/v2/gen-ai/openai/keys/$API_KEY_UUID \
    -X PUT \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $DIGITALOCEAN_ACCESS_TOKEN"
{
  "api_key_info": {
    "created_at": "2023-01-01T00:00:00Z",
    "created_by": "12345",
    "deleted_at": "2023-01-01T00:00:00Z",
    "models": [
      {
        "agreement": {
          "description": "example string",
          "name": "example name",
          "url": "example string",
          "uuid": "123e4567-e89b-12d3-a456-426614174000"
        },
        "created_at": "2023-01-01T00:00:00Z",
        "inference_name": "example name",
        "inference_version": "example string",
        "is_foundational": true,
        "metadata": {},
        "name": "example name",
        "parent_uuid": "123e4567-e89b-12d3-a456-426614174000",
        "provider": "MODEL_PROVIDER_DIGITALOCEAN",
        "updated_at": "2023-01-01T00:00:00Z",
        "upload_complete": true,
        "url": "example string",
        "usecases": [
          "MODEL_USECASE_AGENT",
          "MODEL_USECASE_GUARDRAIL"
        ],
        "uuid": "123e4567-e89b-12d3-a456-426614174000",
        "version": {
          "major": 123,
          "minor": 123,
          "patch": 123
        }
      }
    ],
    "name": "example name",
    "updated_at": "2023-01-01T00:00:00Z",
    "uuid": "123e4567-e89b-12d3-a456-426614174000"
  }
}
Returns Examples
{
  "api_key_info": {
    "created_at": "2023-01-01T00:00:00Z",
    "created_by": "12345",
    "deleted_at": "2023-01-01T00:00:00Z",
    "models": [
      {
        "agreement": {
          "description": "example string",
          "name": "example name",
          "url": "example string",
          "uuid": "123e4567-e89b-12d3-a456-426614174000"
        },
        "created_at": "2023-01-01T00:00:00Z",
        "inference_name": "example name",
        "inference_version": "example string",
        "is_foundational": true,
        "metadata": {},
        "name": "example name",
        "parent_uuid": "123e4567-e89b-12d3-a456-426614174000",
        "provider": "MODEL_PROVIDER_DIGITALOCEAN",
        "updated_at": "2023-01-01T00:00:00Z",
        "upload_complete": true,
        "url": "example string",
        "usecases": [
          "MODEL_USECASE_AGENT",
          "MODEL_USECASE_GUARDRAIL"
        ],
        "uuid": "123e4567-e89b-12d3-a456-426614174000",
        "version": {
          "major": 123,
          "minor": 123,
          "patch": 123
        }
      }
    ],
    "name": "example name",
    "updated_at": "2023-01-01T00:00:00Z",
    "uuid": "123e4567-e89b-12d3-a456-426614174000"
  }
}