Skip to content
forgit api docs

Create a public SSH key for the authenticated user

POST
/user/keys

Adds a public SSH key to the authenticated user’s GitHub account.

OAuth app tokens and personal access tokens (classic) need the write:public_key scope to use this endpoint.

API method documentation

Request Body required

Section titled “ Request Body required ”
Media type application/json
object
title

A descriptive name for the new key.

string
key
required

The public SSH key to add to your GitHub account.

string
/^ssh-(rsa|dss|ed25519) |^ecdsa-sha2-nistp(256|384|521) /
Examples
Example default 
{
  "title": "ssh-rsa AAAAB3NzaC1yc2EAAA",
  "key": "2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234"
}

Responses

Section titled “ Responses ”

201

Section titled “ 201 ”

Response

Media type application/json
Key

Key

object
key
required
string
id
required
integer format: int64
url
required
string
title
required
string
created_at
required
string format: date-time
verified
required
boolean
read_only
required
boolean
last_used
string format: date-time
nullable
Examples
Example default 
{
  "key": "2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234",
  "id": 2,
  "url": "https://api.github.com/user/keys/2",
  "title": "ssh-rsa AAAAB3NzaC1yc2EAAA",
  "created_at": "2020-06-11T21:31:57Z",
  "verified": false,
  "read_only": false
}

304

Section titled “ 304 ”

Not modified

401

Section titled “ 401 ”

Requires authentication

Media type application/json
Basic Error

Basic Error

object
message
string
documentation_url
string
url
string
status
string
Example generated 
{
  "message": "example",
  "documentation_url": "example",
  "url": "example",
  "status": "example"
}

403

Section titled “ 403 ”

Forbidden

Media type application/json
Basic Error

Basic Error

object
message
string
documentation_url
string
url
string
status
string
Example generated 
{
  "message": "example",
  "documentation_url": "example",
  "url": "example",
  "status": "example"
}

404

Section titled “ 404 ”

Resource not found

Media type application/json
Basic Error

Basic Error

object
message
string
documentation_url
string
url
string
status
string
Example generated 
{
  "message": "example",
  "documentation_url": "example",
  "url": "example",
  "status": "example"
}

422

Section titled “ 422 ”

Validation failed, or the endpoint has been spammed.

Media type application/json
Validation Error

Validation Error

object
message
required
string
documentation_url
required
string
errors
Array<object>
object
resource
string
field
string
message
string
code
required
string
index
integer
value
One of:
string
nullable
Example generated 
{
  "message": "example",
  "documentation_url": "example",
  "errors": [
    {
      "resource": "example",
      "field": "example",
      "message": "example",
      "code": "example",
      "index": 1,
      "value": [
        "example"
      ]
    }
  ]
}