provider-keys

Create Org Provider Key

Changed on

Create a provider key in the caller's organization. Organization owners and admins only.

Everything the provider lists on the new credential is offered at once, so a key starts with its real catalog rather than an empty list an admin retypes by hand. A provider that will not say (no listing endpoint, unreachable, credential refused) yields a key with no models rather than a failed create: the credential may still be right for dispatch, and models can be added by name. The response is the key either way; the models are read back through GET /{key_id}/models.

post/api/v1/organizations/me/provider-keys

Request

  • The document declares no server URL.
  • Auth: one of:
    • API key in header Otari-Key
    • API key in header x-api-key

Request body

api_basestring nullable
api_keystring nullable
client_argsobject nullable
namestring required
providerstring required

Response

Successful Response

api_basestring nullable
archived_atstring date-time nullable
client_argsobject nullable
created_atstring date-time required
idstring uuid required
is_org_defaultboolean required
last4string nullable
namestring required
offered_countinteger required

How many models the organization offers on this key. Zero means the key has never been refreshed, so it is unnarrowed and reaches whatever its provider serves.

organization_idstring uuid required
providerstring required
serving_countinteger required

How many of the offered models have their serving switch on. A key offering models and serving none refuses every request through it until one is switched on.

updated_atstring date-time nullable
usableboolean required

False when the stored credential cannot be decrypted on this deployment, so the key supplies nothing at dispatch and the catalog withholds its provider. A row this deployment cannot read is still listed, because deleting or replacing it is what fixes it.

Changes

  • fbee488d4d9fRevision changes
    • info

      added the optional property to the response with the status

  • 2ae458babb5cRevision changes
    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status