Create a known host

POST

/repositories/{workspace}/{repo_slug}/pipelines_config/ssh/known_hosts

Create a repository level known host.

Authorizations

• oauth2
  pipeline:variable
• basic
• api_key

Parameters

Path Parameters

workspace

required

string

This can either be the workspace ID (slug) or the workspace UUID surrounded by curly-braces, for example {workspace UUID}.

repo_slug

required

string

The repository.

Request Body ^required

The known host to create.

Media type application/json

object

type

required

string

uuid

The UUID identifying the known host.

string

hostname

The hostname of the known host.

string

public_key

object

type

required

string

key_type

The type of the public key.

string

key

The base64 encoded public key.

string

md5_fingerprint

The MD5 fingerprint of the public key.

string

sha256_fingerprint

The SHA-256 fingerprint of the public key.

string

Example ^generated

{
  "type": "example",
  "uuid": "example",
  "hostname": "example",
  "public_key": {
    "type": "example",
    "key_type": "example",
    "key": "example",
    "md5_fingerprint": "example",
    "sha256_fingerprint": "example"
  }
}

Responses

201

The known host was created.

Media type application/json

object

type

required

string

uuid

The UUID identifying the known host.

string

hostname

The hostname of the known host.

string

public_key

object

type

required

string

key_type

The type of the public key.

string

key

The base64 encoded public key.

string

md5_fingerprint

The MD5 fingerprint of the public key.

string

sha256_fingerprint

The SHA-256 fingerprint of the public key.

string

Example ^generated

{
  "type": "example",
  "uuid": "example",
  "hostname": "example",
  "public_key": {
    "type": "example",
    "key_type": "example",
    "key": "example",
    "md5_fingerprint": "example",
    "sha256_fingerprint": "example"
  }
}

Headers

Location

string

The URL of the newly created pipeline known host.

404

The account or repository does not exist.

Media type application/json

Error

Base type for most resource objects. It defines the common type element that identifies an object’s type. It also identifies the element as Swagger’s discriminator.

object

type

required

string

error

object

message

required

string

detail

string

data

Optional structured data that is endpoint-specific.

object

key

additional properties

any

key

additional properties

any

Example ^generated

{
  "type": "example",
  "error": {
    "message": "example",
    "detail": "example",
    "data": {}
  }
}

409

A known host with the provided hostname already exists.

Media type application/json

Error

Base type for most resource objects. It defines the common type element that identifies an object’s type. It also identifies the element as Swagger’s discriminator.

object

type

required

string

error

object

message

required

string

detail

string

data

Optional structured data that is endpoint-specific.

object

key

additional properties

any

key

additional properties

any

Example ^generated

{
  "type": "example",
  "error": {
    "message": "example",
    "detail": "example",
    "data": {}
  }
}