• TOC {:toc}

GET /users/:username/keys

Lists the verified public keys for a user. This is accessible by anyone.

<%= headers 200, :pagination => default_pagination_rels %> <%= json(:simple_public_key) { |h| [h] } %>

GET /user/keys

Lists the current user's keys. Requires that you are authenticated via Basic Auth or via OAuth with at least read:public_key scope.

<%= headers 200, :pagination => default_pagination_rels %> <%= json(:public_key) { |h| [h] } %>

View extended details for a single public key. Requires that you are authenticated via Basic Auth or via OAuth with at least read:public_key scope.

GET /user/keys/:id

<%= headers 200 %> <%= json :public_key %>

Creates a public key. Requires that you are authenticated via Basic Auth, or OAuth with at least write:public_key scope.

POST /user/keys

<%= json :title => "octocat@octomac", :key => "ssh-rsa AAA..." %>

<%= headers 201, :Location => "https://api.github.com/user/keys/1" %> <%= json :public_key %>

Public keys are immutable. If you need to update a public key, remove the key and create a new one instead.

Removes a public key. Requires that you are authenticated via Basic Auth or via OAuth with at least admin:public_key scope.

DELETE /user/keys/:id

<%= headers 204 %>