Create Company Certificate

Create a company trusted or untrusted certificate

Create a company trusted or untrusted certificate. Different from V1 in that we reject expired certificates.

POSTyourpodURL.symphony.com/pod/v2/companycert/create

Header parameters

Body

application/json

pemstring

An X509 certificate in PEM format

Example: "-----BEGIN CERTIFICATE-----MIIH/TC...p9DBiB/-----END CERTIFICATE-----"

attributesCompanyCertAttributes (object)

Response

200400401403500

Success

Body

application/json

companyCertAttributesCompanyCertAttributes (object)

companyCertInfoCompanyCertInfo (object)

certInfoCertInfo (array of CertInfoItem (object))

Request

JavaScriptCurlPython

const response = await fetch('yourpodURL.symphony.com/pod/v2/companycert/create', {
    method: 'POST',
    headers: {
      "sessionToken": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400401403500

{
  "companyCertAttributes": {
    "name": "agentservice",
    "type": {
      "type": "USER"
    },
    "status": {
      "type": "TRUSTED"
    }
  },
  "companyCertInfo": {
    "fingerPrint": "300a...",
    "issuerFingerPrint": "450s...",
    "lastSeen": 0,
    "updatedAt": 0,
    "updatedBy": 0,
    "commonName": "agentservice",
    "expiryDate": 1781886755000
  },
  "certInfo": [
    {
      "name": "Validity",
      "attributes": [
        {
          "name": "Not Before",
          "value": "Mon Jan 15 20:56:05 UTC 2018"
        },
        {
          "name": "Not After",
          "value": "Thu Jan 15 20:56:05 UTC 2026"
        }
      ]
    },
    {
      "name": "Public Key",
      "attributes": [
        {
          "name": "Algorithm",
          "value": "RSA"
        },
        {
          "name": "Format",
          "value": "X.509"
        }
      ]
    }
  ]
}

📘 Note

This v2 endpoint rejects expired certificates. When creating company certificates, make sure that you are calling the v2 version of this endpoint, and not v1.

🚧 Roles and privileges

Calling this endpoint requires the USER_PROVISIONING or the SUPER_ADMINISTRATOR role. See Bot Permissions for a list of roles and associated privileges.