List

API Reference

Agents

Evaluation Metrics

OpenAI

Keys

List OpenAI API Keys

get/v2/gen-ai/openai/keys

To list all OpenAI API keys, send a GET request to /v2/gen-ai/openai/keys.

Query ParametersExpand Collapse

page: optional number

Page number.

per_page: optional number

Items per page.

ReturnsExpand Collapse

api_key_infos: optional array of APIOpenAIAPIKeyInfo { created_at, created_by, deleted_at, 4 more }

Api key infos

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

links: optional APILinks { pages }

Links to other pages

pages: optional object { first, last, next, previous }

Information about how to reach other pages

first: optional string

First page

last: optional string

Last page

next: optional string

Next page

previous: optional string

Previous page

meta: optional APIMeta { page, pages, total }

Meta information about the data set

page: optional number

The current page

formatint64

pages: optional number

Total number of pages

formatint64

total: optional number

Total amount of items over all pages

formatint64

List OpenAI API Keys

http

• http
• typescript
• python

curl https://api.digitalocean.com/v2/gen-ai/openai/keys \
    -H "Authorization: Bearer $DIGITALOCEAN_ACCESS_TOKEN"

200 example

{
  "api_key_infos": [
    {
      "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"
    }
  ],
  "links": {
    "pages": {
      "first": "example string",
      "last": "example string",
      "next": "example string",
      "previous": "example string"
    }
  },
  "meta": {
    "page": 123,
    "pages": 123,
    "total": 123
  }
}

Returns Examples

200 example

{
  "api_key_infos": [
    {
      "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"
    }
  ],
  "links": {
    "pages": {
      "first": "example string",
      "last": "example string",
      "next": "example string",
      "previous": "example string"
    }
  },
  "meta": {
    "page": 123,
    "pages": 123,
    "total": 123
  }
}