POST
/
public
/
v1
/
submit
/
create_private_key_tag
Authorizations
Body
enum<string>
required
Enum options:
ACTIVITY_TYPE_CREATE_PRIVATE_KEY_TAGstring
required
Timestamp (in milliseconds) of the request, used to verify liveness of user requests.
string
required
Unique identifier for a given Organization.
object
required
The parameters object containing the specific intent data for this activity.
Show details
Show details
array
required
A list of Private Key IDs.
Show item details
Show item details
Array item type: string
item field
Response
A successful response returns the following fields:object
required
The activity object containing type, intent, and result
Show activity details
Show activity details
The intent of the activity
Show intent details
Show intent details
The createPrivateKeyTagIntent object
Show createPrivateKeyTagIntent details
Show createPrivateKeyTagIntent details
Human-readable name for a Private Key Tag.
The result of the activity
Show result details
Show result details
The createPrivateKeyTagResult object
Show createPrivateKeyTagResult details
Show createPrivateKeyTagResult details
Unique identifier for a given Private Key Tag.
A list of objects representing a particular User’s approval or rejection of a Consensus request, including all relevant metadata.
curl --request POST \
--url https://api.turnkey.com/public/v1/submit/create_private_key_tag \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header "X-Stamp: <string> (see Authorizations)" \
--data '{
"type": "ACTIVITY_TYPE_CREATE_PRIVATE_KEY_TAG",
"timestampMs": "<string> (e.g. 1746736509954)",
"organizationId": "<string> (Your Organization ID)",
"parameters": {
"privateKeyTagName": "<string>",
"privateKeyIds": [
"<string>"
]
}
}'
import { Turnkey } from "@turnkey/sdk-server";
const turnkeyClient = new Turnkey({
apiBaseUrl: "https://api.turnkey.com",
apiPublicKey: process.env.API_PUBLIC_KEY!,
apiPrivateKey: process.env.API_PRIVATE_KEY!,
defaultOrganizationId: process.env.ORGANIZATION_ID!,
});
const response = await turnkeyClient.apiClient().createPrivateKeyTag({
privateKeyTagName: "<string> (Human-readable name for a Private Key Tag.)",
privateKeyIds: ["<string>"] // A list of Private Key IDs.
});
{
"activity": {
"id": "<activity-id>",
"status": "ACTIVITY_STATUS_COMPLETED",
"type": "ACTIVITY_TYPE_CREATE_PRIVATE_KEY_TAG",
"organizationId": "<organization-id>",
"timestampMs": "<timestamp> (e.g. 1746736509954)",
"result": {
"activity": {
"id": "<string>",
"organizationId": "<string>",
"status": "<string>",
"type": "<string>",
"intent": {
"createPrivateKeyTagIntent": {
"privateKeyTagName": "<string>",
"privateKeyIds": [
"<string>"
]
}
},
"result": {
"createPrivateKeyTagResult": {
"privateKeyTagId": "<string>",
"privateKeyIds": [
"<string>"
]
}
},
"votes": "<array>",
"fingerprint": "<string>",
"canApprove": "<boolean>",
"canReject": "<boolean>",
"createdAt": "<string>",
"updatedAt": "<string>"
}
}
}
}