Free API Key

Create Credentials

post https://api.deepgram.com/v1/projects//self-hosted/distribution/credentials

Creates distribution credentials for the specified project

📘

The following information applies only to Console projects which have been granted access to self-hosted products. Please contact Support if you would like access but don't currently have it.

📘

This endpoint was previously available at /projects/{project_id}/onprem/distribution/credentials.

Required Access

If the authenticated account has access to the owner or admin roles, or the keys:write project scope, it will create a new set of distribution credentials in the project.

Create Request

All requests must include the following parameters:

  • comment A friendly name for the distribution credentials.
  • scopes The product scopes granted to the credentials as an Array of Strings.
  • provider The provider for the distribution credentials. Only valid value is "quay".

In addition to the values you provided, a response will include:

  • distribution_credentials_id a unique identifier for this set of distribution credentials as a GUID.
  • username a string of the unique identifier prepended with deepgram+ which can be used as a username for the container registry provider.
  • secret a secret key which can be used as a password for the container registry provider.
    • This is only returned when the key is created. Do not lose this key or you will need to create an entirely new set of distribution credentials. Be sure this key remains a secret.

Distribution Credentials

Distribution credentials are a set of identifiers and a secret which can be used as user login credentials for an associated container registry provider.

As of this writing, the only valid provider Deepgram supports is quay. Click here to learn more about quay.io.

Distribution credentials can be used in conjunction with the docker login command. Prepending deepgram+ to the distribution_credential_id e.g. deepgram+64d1f840-3b7e-43b2-a7b6-d56756d4476d enables you to use the new value for --username:

docker login quay.io --username 'deepgram+64d1f840-3b7e-43b2-a7b6-d56756d4476d'

The minimum set of Deepgram self-hosted product scopes required to run a Deepgram POC is self-hosted:product:api and self-hosted:product:engine.

Read more about roles and scopes.

Language
Authorization
Header