Create a Project Self-Hosted Distribution Credential

POST/v1/projects/{project_id}/self-hosted/distribution/credentialsCreate a Project Self-Hosted Distribution Credential

Creates a set of distribution credentials for the specified project

Parameters

project_idstringpathrequired

The unique identifier of the project

scopesarrayquery

List of permission scopes for the credentials

default ["self-hosted:products"]

providerstringquery

The provider of the distribution service

one of "quay"

one of "quay" · default "quay"

Request body

The set of distribution credentials to create

application/json

objectCreateProjectDistributionCredentialsV1Request

CreateProjectDistributionCredentialsV1Request

Request body for creating distribution credentials

commentstring

Optional comment about the credentials

Example request

{
  "comment": "string"
}

Responses

objectCreateProjectDistributionCredentialsV1Response

CreateProjectDistributionCredentialsV1Response

distribution_credentialsobjectrequired

Show child attributes

commentstring

Optional comment about the credentials

createdstring · date-timerequired

Timestamp when the credentials were created

distribution_credentials_idstring · uuidrequired

Unique identifier for the distribution credentials

providerstringrequired

The provider of the distribution service

scopesarray of stringrequired

List of permission scopes for the credentials

Show child attributes

memberobjectrequired

Show child attributes

emailstring · emailrequired

Email address of the member

member_idstring · uuidrequired

Unique identifier for the member

Example response

{
  "distribution_credentials": {
    "comment": "string",
    "created": "2026-06-09T00:00:00Z",
    "distribution_credentials_id": "00000000-0000-0000-0000-000000000000",
    "provider": "string",
    "scopes": [
      "string"
    ]
  },
  "member": {
    "email": "user@example.com",
    "member_id": "00000000-0000-0000-0000-000000000000"
  }
}

valueErrorResponse

ErrorResponse

oneOf · 3 options

Option 1stringErrorResponseTextError

ErrorResponseTextError

Option 2objectErrorResponseLegacyError

ErrorResponseLegacyError

err_codestring

The error code

err_msgstring

The error message

request_idstring

The request ID

Option 3objectErrorResponseModernError

ErrorResponseModernError

categorystring

The category of the error

detailsstring

A description of the error

messagestring

A message about the error

request_idstring

The unique identifier of the request

Example response

{
  "err_code": "string",
  "err_msg": "string",
  "request_id": "string"
}

Examples

project_idrequiredpath parameter

scopesquery parameter

providerquery parameter

curl -X POST 'https://agent.deepgram.com/v1/projects/string/self-hosted/distribution/credentials?provider=quay&scopes=%5B%22self-hosted%3Aproducts%22%5D' \
  -H 'Content-Type: application/json' \
  -d '{"comment":"string"}'

const response = await fetch('https://agent.deepgram.com/v1/projects/string/self-hosted/distribution/credentials?provider=quay&scopes=%5B%22self-hosted%3Aproducts%22%5D', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"comment":"string"}),
});
const data = await response.json();

const response = await fetch('https://agent.deepgram.com/v1/projects/string/self-hosted/distribution/credentials?provider=quay&scopes=%5B%22self-hosted%3Aproducts%22%5D', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: "{\"comment\":\"string\"}" });
console.log(await response.json());

import requests

response = requests.request(
    "POST",
    "https://agent.deepgram.com/v1/projects/string/self-hosted/distribution/credentials?provider=quay&scopes=%5B%22self-hosted%3Aproducts%22%5D",
    headers={"Content-Type": "application/json"},
    data='{"comment":"string"}',
)
print(response.json())

package main

import (
	"context"
	"net/http"
	"strings"
)

func main() {
	ctx := context.Background()
	body := strings.NewReader(`{"comment":"string"}`)
	req, err := http.NewRequestWithContext(ctx, "POST", "https://agent.deepgram.com/v1/projects/string/self-hosted/distribution/credentials?provider=quay&scopes=%5B%22self-hosted%3Aproducts%22%5D", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
}

<?php
$request = curl_init("https://agent.deepgram.com/v1/projects/string/self-hosted/distribution/credentials?provider=quay&scopes=%5B%22self-hosted%3Aproducts%22%5D");
curl_setopt($request, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($request, CURLOPT_POSTFIELDS, "{\"comment\":\"string\"}");
curl_setopt($request, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
$response = curl_exec($request);
curl_close($request);

var request = HttpRequest.newBuilder(URI.create("https://agent.deepgram.com/v1/projects/string/self-hosted/distribution/credentials?provider=quay&scopes=%5B%22self-hosted%3Aproducts%22%5D"))
    .method("POST", HttpRequest.BodyPublishers.noBody())
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"comment\":\"string\"}"))
    .build();
var response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());

require 'net/http'

uri = URI("https://agent.deepgram.com/v1/projects/string/self-hosted/distribution/credentials?provider=quay&scopes=%5B%22self-hosted%3Aproducts%22%5D")
request = Net::HTTPGenericRequest.new("POST", true, true, uri)
request['Content-Type'] = 'application/json'
request.body = "{\"comment\":\"string\"}"
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://agent.deepgram.com/v1/projects/string/self-hosted/distribution/credentials?provider=quay&scopes=%5B%22self-hosted%3Aproducts%22%5D");
request.Content = new StringContent("{\"comment\":\"string\"}", Encoding.UTF8, "application/json");
using var response = await client.SendAsync(request);

{
  "distribution_credentials": {
    "comment": "string",
    "created": "2026-06-09T00:00:00Z",
    "distribution_credentials_id": "00000000-0000-0000-0000-000000000000",
    "provider": "string",
    "scopes": [
      "string"
    ]
  },
  "member": {
    "email": "user@example.com",
    "member_id": "00000000-0000-0000-0000-000000000000"
  }
}

{
  "err_code": "string",
  "err_msg": "string",
  "request_id": "string"
}