Create a GPG key

POST

/user/gpg_keys

curl --request POST \
  --url https://gitea.com/api/v1/user/gpg_keys \
  --header 'Authorization: Basic <credentials>' \
  --header 'Content-Type: application/json' \
  --data '{ "armored_public_key": "example", "armored_signature": "example" }'

Authorizations

• BasicAuth
• Token
• AccessToken
• 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
}

404

APINotFound is a not found empty response

Media typeapplication/json

422

APIValidationError is error format response related to input validation

Media typeapplication/json

Headers

message

string

url

string