Enable a deploy key

POST

/api/v4/projects/{id}/deploy_keys/{key_id}/enable

• GitLab REST API

Enables a deploy key for a project so this can be used. Returns the enabled key, with a status code 201 when successful.

Authorizations

• http
• oauth2

Parameters

Path Parameters

id

required

One of:

string

string

integer

integer

The ID or URL-encoded path of the project owned by the authenticated user

key_id

required

integer

The ID of the deploy key

Responses

201

Created

Media type application/json

object

id

integer format: int64

title

string

created_at

string format: date-time

expires_at

string format: date-time

last_used_at

string format: date-time

key

string

usage_type

string

fingerprint

string

fingerprint_sha256

string

projects_with_write_access

object

id

integer format: int64

description

string

name

string

name_with_namespace

string

path

string

path_with_namespace

string

created_at

string format: date-time

projects_with_readonly_access

object

id

integer format: int64

description

string

name

string

name_with_namespace

string

path

string

path_with_namespace

string

created_at

string format: date-time

Example

{
  "id": 1,
  "title": "Sample key 25",
  "created_at": "2015-09-03T07:24:44.627Z",
  "expires_at": "2020-09-03T07:24:44.627Z",
  "last_used_at": "2020-09-03T07:24:44.627Z",
  "key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDNJAkI3Wdf0r13c8a5pEExB2YowPWCSVzfZV22pNBc1CuEbyYLHpUyaD0GwpGvFdx2aP7lMEk35k6Rz3ccBF6jRaVJyhsn5VNnW92PMpBJ/P1UebhXwsFHdQf5rTt082cSxWuk61kGWRQtk4ozt/J2DF/dIUVaLvc+z4HomT41fQ==",
  "usage_type": "auth",
  "fingerprint": "4a:9d:64:15:ed:3a:e6:07:6e:89:36:b3:3b:03:05:d9",
  "fingerprint_sha256": "SHA256:Jrs3LD1Ji30xNLtTVf9NDCj7kkBgPBb2pjvTZ3HfIgU",
  "projects_with_write_access": {
    "id": 1,
    "description": "desc",
    "name": "project1",
    "name_with_namespace": "John Doe / project1",
    "path": "project1",
    "path_with_namespace": "namespace1/project1",
    "created_at": "2020-05-07T04:27:17.016Z"
  },
  "projects_with_readonly_access": {
    "id": 1,
    "description": "desc",
    "name": "project1",
    "name_with_namespace": "John Doe / project1",
    "path": "project1",
    "path_with_namespace": "namespace1/project1",
    "created_at": "2020-05-07T04:27:17.016Z"
  }
}

400

Bad Request

401

Unauthorized

404

Not found