Skip to main content

Create a server (v2)

POST 

/tap/api/v2/servers

deprecated

This endpoint has been deprecated and may be replaced or removed in future versions of the API.

Deprecated; use POST /tap/api/v3/servers. Differs from v3 only in awsRoles: the request accepts AWS role objects, of which only id is read, as well as AWS role ids, and the response lists AWS role objects. Creates a server and issues its certificate. When csr is not blank, the CSR is signed and the certificate bundle contains no private key; otherwise a key pair and password are generated. Each AWS role id in awsRoles must belong to an existing AWS role; the default AWS roles are assigned when awsRoles is omitted or empty. Requires the admin role. When the sendWelcomeEmail setting is on and email integration is enabled, the custodian is sent an email; it includes a download link valid for 12 hours by default when the showBundleLinks setting is on, and attaches the bundle when the sendWelcomeEmailWithAttachment setting is on. If the download link cannot be generated, the server is still created but no email is sent, and POST /tap/api/v3/servers/{serverId}/resend can send it later. bundlePath in the response is the stored location of the certificate bundle, not a download link.

Request​

Responses​

The created server.