Skip to main content
POST
/
api
/
v1
/
ssh
/
hosts
cURL
curl --request POST \
  --url https://us.infisical.com/api/v1/ssh/hosts \
  --header 'Content-Type: application/json' \
  --data '{
  "projectId": "<string>",
  "hostname": "<string>",
  "alias": "",
  "userCertTtl": "8h",
  "hostCertTtl": "1y",
  "loginMappings": [],
  "userSshCaId": "<string>",
  "hostSshCaId": "<string>"
}'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "projectId": "<string>",
  "hostname": "<string>",
  "alias": "<string>",
  "userCertTtl": "<string>",
  "hostCertTtl": "<string>",
  "userSshCaId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "hostSshCaId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "loginMappings": [
    {
      "loginUser": "<string>",
      "allowedPrincipals": {
        "usernames": [
          "<string>"
        ],
        "groups": [
          "<string>"
        ]
      },
      "source": "host"
    }
  ]
}

Body

application/json
projectId
string
required
hostname
string
required
Minimum length: 1
alias
string
default:""
Maximum length: 64
userCertTtl
string
default:8h
hostCertTtl
string
default:1y
loginMappings
object[]
userSshCaId
string
hostSshCaId
string

Response

id
string<uuid>
required
projectId
string
required
hostname
string
required
userCertTtl
string
required
hostCertTtl
string
required
userSshCaId
string<uuid>
required
hostSshCaId
string<uuid>
required
loginMappings
object[]
required
alias
string | null