gitlab-org--gitlab-foss/doc/api/deploy_keys.md
Dmitriy Zaporozhets 68d146b4a6 Improve api docs
2013-06-06 13:19:23 +03:00

1.8 KiB

Deploy Keys

List deploy keys

Get a list of a project's deploy keys.

GET /projects/:id/keys

Parameters:

  • id (required) - The ID of the project
[
  {
    "id": 1,
    "title" : "Public key"
    "key": "ssh-rsa AAAAB3NzaC1yc2EAAAABJQAAAIEAiPWx6WM4lhHNedGfBpPJNPpZ7yKu+dnn1SJejgt4
      596k6YjzGGphH2TUxwKzxcKDKKezwkpfnxPkSMkuEspGRt/aZZ9wa++Oi7Qkr8prgHc4
      soW6NUlfDzpvZK2H5E7eQaSeP3SAwGmQKUFHCddNaP0L+hM7zhFNzjFvpaMgJw0=",
  },
  {
    "id": 3,
    "title" : "Another Public key"
    "key": "ssh-rsa AAAAB3NzaC1yc2EAAAABJQAAAIEAiPWx6WM4lhHNedGfBpPJNPpZ7yKu+dnn1SJejgt4
      596k6YjzGGphH2TUxwKzxcKDKKezwkpfnxPkSMkuEspGRt/aZZ9wa++Oi7Qkr8prgHc4
      soW6NUlfDzpvZK2H5E7eQaSeP3SAwGmQKUFHCddNaP0L+hM7zhFNzjFvpaMgJw0="
  }
]

Single deploy key

Get a single key.

GET /projects/:id/keys/:key_id

Parameters:

  • id (required) - The ID of the project
  • key_id (required) - The ID of the deploy key
{
  "id": 1,
  "title" : "Public key"
  "key": "ssh-rsa AAAAB3NzaC1yc2EAAAABJQAAAIEAiPWx6WM4lhHNedGfBpPJNPpZ7yKu+dnn1SJejgt4
      596k6YjzGGphH2TUxwKzxcKDKKezwkpfnxPkSMkuEspGRt/aZZ9wa++Oi7Qkr8prgHc4
      soW6NUlfDzpvZK2H5E7eQaSeP3SAwGmQKUFHCddNaP0L+hM7zhFNzjFvpaMgJw0="
}

Add deploy key

Creates a new deploy key for a project. If deploy key already exists in another project - it will be joined to project but only if original one was is accessible by same user

POST /projects/:id/keys

Parameters:

  • id (required) - The ID of the project
  • title (required) - New deploy key's title
  • key (required) - New deploy key

Delete deploy key

Delete a deploy key from a project

DELETE /projects/:id/keys/:key_id

Parameters:

  • id (required) - The ID of the project
  • key_id (required) - The ID of the deploy key