Team / Integrations /

Update SSH identity

Updates SSH identity data.

Required permission

Account > Ssh > General > Update

Path parameters

identityId
string required
ID of the SSH identity

Request body

{object}

description
string
max length
200
pattern
^[a-zA-Z0-9.,?\s\\/'"()[\];`%^&*\-_:!]+$
sshPublicKeys
[array]
A list of SSH public keys.

{object}

key
string required
The SSH public key.

restrictions
{object}

projects
{object}

enabled
boolean
Whether restriction by project should be enabled.
items
[array]
An array of previously defined projects.

string
min length
3
max length
100
pattern
^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$

tags
{object}

enabled
boolean
Whether restriction by tag should be enabled.
items
[array]
An array of previously defined tags to help identify and group the resource.

string
min length
3
max length
100
pattern
^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$

matchCondition
string
If all or any of the tags must be present on the target for it to match the condition.
one of
and, or

updatedAt
string
time of update
createdAt
string
time of creation

Response body

{object}
Response object.

data
{object} required
Result data.

API

CLI

JS Client

PATCH /v1/integrations/ssh-identities/{identityId}

PATCH /v1/teams/{teamId}/integrations/ssh-identities/{identityId}

Example request

Request body

curl --header "Content-Type: application/json" \
  --header "Authorization: Bearer NORTHFLANK_API_TOKEN" \
  --request PATCH \
  --data '{"sshPublicKeys":[{"key":"ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ..."}],"restrictions":{"projects":{"enabled":false},"tags":{"enabled":false,"matchCondition":"or"}}}' \
  https://api.northflank.com/v1/integrations/ssh-identities/{identityId}

Example response

200 OK

The operation was performed successfully.

JSON

{
  "data": {}
}