Add a GPG public key to current user's account

POST

/user/gpg_keys

Authorizations

• BasicAuth
• AuthorizationHeaderToken
• SudoParam
• SudoHeader
• TOTPHeader

Request Body

Media typeapplication/json

CreateGPGKeyOption options create user GPG key

object

armored_public_key

required

An armored GPG key to add

string

unique items

armored_signature

string

Example^generated

{
  "armored_public_key": "example",
  "armored_signature": "example"
}

Responses

201

GPGKey

Media typeapplication/json

GPGKey a user GPG key to sign commit and tag in repository

object

can_certify

boolean

can_encrypt_comms

boolean

can_encrypt_storage

boolean

can_sign

boolean

created_at

string format: date-time

emails

Array<object>

GPGKeyEmail an email attached to a GPGKey

object

email

string

verified

boolean

expires_at

string format: date-time

id

integer format: int64

key_id

string

primary_key_id

string

public_key

string

subkeys

Array<object> recursive

verified

boolean

Example^generated

{
  "can_certify": true,
  "can_encrypt_comms": true,
  "can_encrypt_storage": true,
  "can_sign": true,
  "created_at": "2026-04-15T12:00:00Z",
  "emails": [
    {
      "email": "example",
      "verified": true
    }
  ],
  "expires_at": "2026-04-15T12:00:00Z",
  "id": 1,
  "key_id": "example",
  "primary_key_id": "example",
  "public_key": "example",
  "subkeys": [],
  "verified": true
}

401

APIUnauthorizedError is a unauthorized error response

Media typeapplication/json

object

message

string

url

string

Example^generated

{
  "message": "example",
  "url": "example"
}

403

APIForbiddenError is a forbidden error response

Media typeapplication/json

object

message

string

url

string

Example^generated

{
  "message": "example",
  "url": "example"
}

404

APINotFound is a not found error response

Media typeapplication/json

object

errors

Array<string>

message

string

url

string

Example^generated

{
  "errors": [
    "example"
  ],
  "message": "example",
  "url": "example"
}

422

APIValidationError is error format response related to input validation

Media typeapplication/json

object

message

string

url

string

Example^generated

{
  "message": "example",
  "url": "example"
}