Create client key from file

curl --request POST \
  --url https://api.extole.io/v2/settings/security/keys/upload \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'clientKeyCreateRequest={
  "algorithm": "SSL_PKCS_12",
  "component_ids": [
    "component_id"
  ],
  "component_references": [
    {
      "component_id": "component_id",
      "socket_names": [
        "socket_name"
      ]
    }
  ],
  "description": "description",
  "name": "name",
  "partner_key_id": "partner_key_id",
  "password": "password",
  "tags": [
    "tag"
  ],
  "type": "JWT"
}' \
  --form 'fileInputStreamRequest={
  "attributes": {
    "fileName": "fileName",
    "size": 1
  },
  "inputStream": {}
}'

import requests

url = "https://api.extole.io/v2/settings/security/keys/upload"

payload = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"clientKeyCreateRequest\"\r\n\r\n{\r\n  \"algorithm\": \"SSL_PKCS_12\",\r\n  \"component_ids\": [\r\n    \"component_id\"\r\n  ],\r\n  \"component_references\": [\r\n    {\r\n      \"component_id\": \"component_id\",\r\n      \"socket_names\": [\r\n        \"socket_name\"\r\n      ]\r\n    }\r\n  ],\r\n  \"description\": \"description\",\r\n  \"name\": \"name\",\r\n  \"partner_key_id\": \"partner_key_id\",\r\n  \"password\": \"password\",\r\n  \"tags\": [\r\n    \"tag\"\r\n  ],\r\n  \"type\": \"JWT\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"fileInputStreamRequest\"\r\n\r\n{\r\n  \"attributes\": {\r\n    \"fileName\": \"fileName\",\r\n    \"size\": 1\r\n  },\r\n  \"inputStream\": {}\r\n}\r\n-----011000010111000001101001--"
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "multipart/form-data"
}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

const form = new FormData();
form.append('clientKeyCreateRequest', '{
  "algorithm": "SSL_PKCS_12",
  "component_ids": [
    "component_id"
  ],
  "component_references": [
    {
      "component_id": "component_id",
      "socket_names": [
        "socket_name"
      ]
    }
  ],
  "description": "description",
  "name": "name",
  "partner_key_id": "partner_key_id",
  "password": "password",
  "tags": [
    "tag"
  ],
  "type": "JWT"
}');
form.append('fileInputStreamRequest', '{
  "attributes": {
    "fileName": "fileName",
    "size": 1
  },
  "inputStream": {}
}');

const options = {method: 'POST', headers: {Authorization: '<api-key>'}};

options.body = form;

fetch('https://api.extole.io/v2/settings/security/keys/upload', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.extole.io/v2/settings/security/keys/upload",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"clientKeyCreateRequest\"\r\n\r\n{\r\n  \"algorithm\": \"SSL_PKCS_12\",\r\n  \"component_ids\": [\r\n    \"component_id\"\r\n  ],\r\n  \"component_references\": [\r\n    {\r\n      \"component_id\": \"component_id\",\r\n      \"socket_names\": [\r\n        \"socket_name\"\r\n      ]\r\n    }\r\n  ],\r\n  \"description\": \"description\",\r\n  \"name\": \"name\",\r\n  \"partner_key_id\": \"partner_key_id\",\r\n  \"password\": \"password\",\r\n  \"tags\": [\r\n    \"tag\"\r\n  ],\r\n  \"type\": \"JWT\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"fileInputStreamRequest\"\r\n\r\n{\r\n  \"attributes\": {\r\n    \"fileName\": \"fileName\",\r\n    \"size\": 1\r\n  },\r\n  \"inputStream\": {}\r\n}\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: multipart/form-data"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.extole.io/v2/settings/security/keys/upload"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"clientKeyCreateRequest\"\r\n\r\n{\r\n  \"algorithm\": \"SSL_PKCS_12\",\r\n  \"component_ids\": [\r\n    \"component_id\"\r\n  ],\r\n  \"component_references\": [\r\n    {\r\n      \"component_id\": \"component_id\",\r\n      \"socket_names\": [\r\n        \"socket_name\"\r\n      ]\r\n    }\r\n  ],\r\n  \"description\": \"description\",\r\n  \"name\": \"name\",\r\n  \"partner_key_id\": \"partner_key_id\",\r\n  \"password\": \"password\",\r\n  \"tags\": [\r\n    \"tag\"\r\n  ],\r\n  \"type\": \"JWT\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"fileInputStreamRequest\"\r\n\r\n{\r\n  \"attributes\": {\r\n    \"fileName\": \"fileName\",\r\n    \"size\": 1\r\n  },\r\n  \"inputStream\": {}\r\n}\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.extole.io/v2/settings/security/keys/upload")
  .header("Authorization", "<api-key>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"clientKeyCreateRequest\"\r\n\r\n{\r\n  \"algorithm\": \"SSL_PKCS_12\",\r\n  \"component_ids\": [\r\n    \"component_id\"\r\n  ],\r\n  \"component_references\": [\r\n    {\r\n      \"component_id\": \"component_id\",\r\n      \"socket_names\": [\r\n        \"socket_name\"\r\n      ]\r\n    }\r\n  ],\r\n  \"description\": \"description\",\r\n  \"name\": \"name\",\r\n  \"partner_key_id\": \"partner_key_id\",\r\n  \"password\": \"password\",\r\n  \"tags\": [\r\n    \"tag\"\r\n  ],\r\n  \"type\": \"JWT\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"fileInputStreamRequest\"\r\n\r\n{\r\n  \"attributes\": {\r\n    \"fileName\": \"fileName\",\r\n    \"size\": 1\r\n  },\r\n  \"inputStream\": {}\r\n}\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.extole.io/v2/settings/security/keys/upload")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"clientKeyCreateRequest\"\r\n\r\n{\r\n  \"algorithm\": \"SSL_PKCS_12\",\r\n  \"component_ids\": [\r\n    \"component_id\"\r\n  ],\r\n  \"component_references\": [\r\n    {\r\n      \"component_id\": \"component_id\",\r\n      \"socket_names\": [\r\n        \"socket_name\"\r\n      ]\r\n    }\r\n  ],\r\n  \"description\": \"description\",\r\n  \"name\": \"name\",\r\n  \"partner_key_id\": \"partner_key_id\",\r\n  \"password\": \"password\",\r\n  \"tags\": [\r\n    \"tag\"\r\n  ],\r\n  \"type\": \"JWT\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"fileInputStreamRequest\"\r\n\r\n{\r\n  \"attributes\": {\r\n    \"fileName\": \"fileName\",\r\n    \"size\": 1\r\n  },\r\n  \"inputStream\": {}\r\n}\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "algorithm": "A128KW",
  "component_ids": [
    "<string>"
  ],
  "component_references": [
    {
      "component_id": "<string>",
      "socket_names": [
        "<string>"
      ]
    }
  ],
  "created_at": "2025-10-24T02:00:00-07:00",
  "description": "<string>",
  "id": "<string>",
  "key": "<string>",
  "name": "<string>",
  "partner_key_id": "<string>",
  "tags": [
    "<string>"
  ],
  "type": "JWT",
  "updated_at": "2025-10-24T02:00:00-07:00"
}

POST

settings

security

keys

upload

Create client key from file

curl --request POST \
  --url https://api.extole.io/v2/settings/security/keys/upload \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'clientKeyCreateRequest={
  "algorithm": "SSL_PKCS_12",
  "component_ids": [
    "component_id"
  ],
  "component_references": [
    {
      "component_id": "component_id",
      "socket_names": [
        "socket_name"
      ]
    }
  ],
  "description": "description",
  "name": "name",
  "partner_key_id": "partner_key_id",
  "password": "password",
  "tags": [
    "tag"
  ],
  "type": "JWT"
}' \
  --form 'fileInputStreamRequest={
  "attributes": {
    "fileName": "fileName",
    "size": 1
  },
  "inputStream": {}
}'

import requests

url = "https://api.extole.io/v2/settings/security/keys/upload"

payload = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"clientKeyCreateRequest\"\r\n\r\n{\r\n  \"algorithm\": \"SSL_PKCS_12\",\r\n  \"component_ids\": [\r\n    \"component_id\"\r\n  ],\r\n  \"component_references\": [\r\n    {\r\n      \"component_id\": \"component_id\",\r\n      \"socket_names\": [\r\n        \"socket_name\"\r\n      ]\r\n    }\r\n  ],\r\n  \"description\": \"description\",\r\n  \"name\": \"name\",\r\n  \"partner_key_id\": \"partner_key_id\",\r\n  \"password\": \"password\",\r\n  \"tags\": [\r\n    \"tag\"\r\n  ],\r\n  \"type\": \"JWT\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"fileInputStreamRequest\"\r\n\r\n{\r\n  \"attributes\": {\r\n    \"fileName\": \"fileName\",\r\n    \"size\": 1\r\n  },\r\n  \"inputStream\": {}\r\n}\r\n-----011000010111000001101001--"
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "multipart/form-data"
}

response = requests.post(url, data=payload, headers=headers)

print(response.text)

const form = new FormData();
form.append('clientKeyCreateRequest', '{
  "algorithm": "SSL_PKCS_12",
  "component_ids": [
    "component_id"
  ],
  "component_references": [
    {
      "component_id": "component_id",
      "socket_names": [
        "socket_name"
      ]
    }
  ],
  "description": "description",
  "name": "name",
  "partner_key_id": "partner_key_id",
  "password": "password",
  "tags": [
    "tag"
  ],
  "type": "JWT"
}');
form.append('fileInputStreamRequest', '{
  "attributes": {
    "fileName": "fileName",
    "size": 1
  },
  "inputStream": {}
}');

const options = {method: 'POST', headers: {Authorization: '<api-key>'}};

options.body = form;

fetch('https://api.extole.io/v2/settings/security/keys/upload', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.extole.io/v2/settings/security/keys/upload",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"clientKeyCreateRequest\"\r\n\r\n{\r\n  \"algorithm\": \"SSL_PKCS_12\",\r\n  \"component_ids\": [\r\n    \"component_id\"\r\n  ],\r\n  \"component_references\": [\r\n    {\r\n      \"component_id\": \"component_id\",\r\n      \"socket_names\": [\r\n        \"socket_name\"\r\n      ]\r\n    }\r\n  ],\r\n  \"description\": \"description\",\r\n  \"name\": \"name\",\r\n  \"partner_key_id\": \"partner_key_id\",\r\n  \"password\": \"password\",\r\n  \"tags\": [\r\n    \"tag\"\r\n  ],\r\n  \"type\": \"JWT\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"fileInputStreamRequest\"\r\n\r\n{\r\n  \"attributes\": {\r\n    \"fileName\": \"fileName\",\r\n    \"size\": 1\r\n  },\r\n  \"inputStream\": {}\r\n}\r\n-----011000010111000001101001--",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: multipart/form-data"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.extole.io/v2/settings/security/keys/upload"

	payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"clientKeyCreateRequest\"\r\n\r\n{\r\n  \"algorithm\": \"SSL_PKCS_12\",\r\n  \"component_ids\": [\r\n    \"component_id\"\r\n  ],\r\n  \"component_references\": [\r\n    {\r\n      \"component_id\": \"component_id\",\r\n      \"socket_names\": [\r\n        \"socket_name\"\r\n      ]\r\n    }\r\n  ],\r\n  \"description\": \"description\",\r\n  \"name\": \"name\",\r\n  \"partner_key_id\": \"partner_key_id\",\r\n  \"password\": \"password\",\r\n  \"tags\": [\r\n    \"tag\"\r\n  ],\r\n  \"type\": \"JWT\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"fileInputStreamRequest\"\r\n\r\n{\r\n  \"attributes\": {\r\n    \"fileName\": \"fileName\",\r\n    \"size\": 1\r\n  },\r\n  \"inputStream\": {}\r\n}\r\n-----011000010111000001101001--")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.extole.io/v2/settings/security/keys/upload")
  .header("Authorization", "<api-key>")
  .body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"clientKeyCreateRequest\"\r\n\r\n{\r\n  \"algorithm\": \"SSL_PKCS_12\",\r\n  \"component_ids\": [\r\n    \"component_id\"\r\n  ],\r\n  \"component_references\": [\r\n    {\r\n      \"component_id\": \"component_id\",\r\n      \"socket_names\": [\r\n        \"socket_name\"\r\n      ]\r\n    }\r\n  ],\r\n  \"description\": \"description\",\r\n  \"name\": \"name\",\r\n  \"partner_key_id\": \"partner_key_id\",\r\n  \"password\": \"password\",\r\n  \"tags\": [\r\n    \"tag\"\r\n  ],\r\n  \"type\": \"JWT\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"fileInputStreamRequest\"\r\n\r\n{\r\n  \"attributes\": {\r\n    \"fileName\": \"fileName\",\r\n    \"size\": 1\r\n  },\r\n  \"inputStream\": {}\r\n}\r\n-----011000010111000001101001--")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.extole.io/v2/settings/security/keys/upload")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"clientKeyCreateRequest\"\r\n\r\n{\r\n  \"algorithm\": \"SSL_PKCS_12\",\r\n  \"component_ids\": [\r\n    \"component_id\"\r\n  ],\r\n  \"component_references\": [\r\n    {\r\n      \"component_id\": \"component_id\",\r\n      \"socket_names\": [\r\n        \"socket_name\"\r\n      ]\r\n    }\r\n  ],\r\n  \"description\": \"description\",\r\n  \"name\": \"name\",\r\n  \"partner_key_id\": \"partner_key_id\",\r\n  \"password\": \"password\",\r\n  \"tags\": [\r\n    \"tag\"\r\n  ],\r\n  \"type\": \"JWT\"\r\n}\r\n-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"fileInputStreamRequest\"\r\n\r\n{\r\n  \"attributes\": {\r\n    \"fileName\": \"fileName\",\r\n    \"size\": 1\r\n  },\r\n  \"inputStream\": {}\r\n}\r\n-----011000010111000001101001--"

response = http.request(request)
puts response.read_body

{
  "algorithm": "A128KW",
  "component_ids": [
    "<string>"
  ],
  "component_references": [
    {
      "component_id": "<string>",
      "socket_names": [
        "<string>"
      ]
    }
  ],
  "created_at": "2025-10-24T02:00:00-07:00",
  "description": "<string>",
  "id": "<string>",
  "key": "<string>",
  "name": "<string>",
  "partner_key_id": "<string>",
  "tags": [
    "<string>"
  ],
  "type": "JWT",
  "updated_at": "2025-10-24T02:00:00-07:00"
}

Authorizations

Authorization

string

header

required

Body

multipart/form-data

clientKeyCreateRequest

object

required

Show child attributes

fileInputStreamRequest

object

required

Show child attributes

Response

Successful response

Stored generic client key definition. Fields name and description are unevaluated and appear in buildtime-evaluatable form.

algorithm

enum<string>

required

Cryptographic or integration algorithm. Discriminator for polymorphic create, update, and response schemas.

Available options:

A128KW,

A192KW,

A256KW,

ES256_PRIVATE,

ES256_PUBLIC,

ES384_PRIVATE,

ES384_PUBLIC,

ES512_PRIVATE,

ES512_PUBLIC,

HS256,

HS384,

HS512,

HTTP_BASIC,

PASSWORD,

PS256_PRIVATE,

PS256_PUBLIC,

PS384_PRIVATE,

PS384_PUBLIC,

PS512_PRIVATE,

PS512_PUBLIC,

RS256_PRIVATE,

RS256_PUBLIC,

RS384_PRIVATE,

RS384_PUBLIC,

RS512_PRIVATE,

RS512_PUBLIC,

RSA,

RSA_OAEP_256_PRIVATE,

RSA_OAEP_256_PUBLIC,

RSA_OAEP_384_PRIVATE,

RSA_OAEP_384_PUBLIC,

RSA_OAEP_512_PRIVATE,

RSA_OAEP_512_PUBLIC

component_ids

string[]

required

component_references

object[]

required

Show child attributes

created_at

string

required

RFC 3339 or RFC 9557 date-time with a numeric UTC offset and an optional IANA time-zone suffix in square brackets. Precision up to milliseconds.

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,3})?(Z|[+-](?:[01][0-9]|2[0-3]):[0-5][0-9])(\[[^\]]+\])?$

Example:

"2025-10-24T02:00:00-07:00"

description

required

Optional build-time expression that resolves to a human-readable description. Buildtime expressions use ClientKeyBuildtimeContext.

string

required

read-only

Stable Extole identifier for the client key.

key

string

required

Key material in the same encoding accepted on create. Symmetric secrets and private keys are partially masked in API responses; public keys are returned in full PEM form.

name

required

Display name for the key, in the same build-time evaluatable form that was supplied on create or update. Buildtime expressions use ClientKeyBuildtimeContext.

partner_key_id

string

required

External key identifier used to match tokens or credentials to this key (for example the JWT kid header).

Getting Started

Consumer to Extole API

Server to Extole API

Management API

Create client key from file

Authorizations

Body

Response