v1

latestOpenAPI 3.1.02026-08-04164270844.7 KB
Users

Import a certificate

🔑

Required OAuth scope: users:write.

Imports a certificate for a specific user given its unique ID.

post/api/v2/users/{userId}/certificates

Path parameters

userIdstring ObjectId required
Example:507f1f77bcf86cd799439011

The unique ID of the user.

Headers

360-api-version'v2.0' required

The version of the API.

Response

Returns the created user's certificate.

deliveryDatestring date-time required

The delivery date of the certificate, in the YYYY-MM-DDThh:mm:ss.sssZ format (ISO 8601 in Coordinated Universal Time (UTC)).

expirationDatestring date-time

The expiration date of the certificate, in the YYYY-MM-DDThh:mm:ss.sssZ format (ISO 8601 in Coordinated Universal Time (UTC)).

titlestring required

The title of the certificate outline in the platform (internal name of the certificate).

_idstring ObjectId required

The unique ID of the user certificate.

validityPeriodnumber

The length of time, in months, for which the certificate is valid.

certificateOutlineIdstring ObjectId

The unique ID of the outline of the certificate.

type'external' required

The type of the certificate in the platform.

Example response

{
  "title": "Certificate of Completion",
  "_id": "507f1f77bcf86cd799439011",
  "certificateOutlineId": "507f1f77bcf86cd799439011",
  "type": "external"
}