Upload certificate | Sample

2 body fields

The certificate upload payload.

namestringoptional

An optional name for the certificate

certificatestringrequired

The certificate content in PEM format

2 status codes

200Certificate uploaded successfully.

objectstringrequired

The object type. - If creating, updating, or getting a specific certificate, the object type is `certificate`. - If listing, activating, or deactivating certificates for the organization, the object type is `organization.certificate`. - If listing, activating, or deactivating certificates for a project, the object type is `organization.project.certificate`.

Allowed:certificateorganization.certificateorganization.project.certificate

idstringrequired

The identifier, which can be referenced in API endpoints

namestringrequired

The name of the certificate.

created_atintegerrequired

The Unix timestamp (in seconds) of when the certificate was uploaded.

certificate_detailsobjectrequired

activebooleanoptional

Whether the certificate is currently active at the specified scope. Not returned when getting details for a specific certificate.

429The request was rejected because a rate limit was exceeded.

errorobjectrequired

Error handling

A 429 is returned: The request was rejected because a rate limit was exceeded.

import { Client } from "acme-sdk";

const client = new Client({
  baseUrl: "https://api.acme.com",
  auth: { bearer: process.env.API_TOKEN },
  retry: {
    maxAttempts: 3,
    retryOn: [
      408,
      425,
      429,
      500,
      502,
      503,
      504,
    ],
    backoffMs: 500,
    maxBackoffMs: 8000,
  },
  timeoutMs: 30000,
});

const result = await client.certificates.create({
  certificate: "example",
  name: "Untitled",
});

{
  "object": "certificate",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Example Name",
  "created_at": 1,
  "certificate_details": {
    "valid_at": 1,
    "expires_at": 1,
    "content": "example_value"
  },
  "active": true
}

Request

Response

Errors