Issue an AI data plane certificate
POST /api/ai_gateway_groups/{ai_gateway_group_id}/dp_client_certificates
POST /api/ai_gateway_groups/{ai_gateway_group_id}/dp_client_certificatesInteractive request editor loads with JavaScript.
X-API-KEY<token>
In: header
Path Parameters
ai_gateway_group_id*string
AI Gateway group ID.
Length
1 <= lengthResponse Body
application/json
application/json
application/json
curl -X POST "$API_BASE_URL/api/ai_gateway_groups/abc1234567890/dp_client_certificates"Data plane certificate issued successfully.
{
"value": {
"id": "bd58fce2-b6cc-4d2d-a53c-6ce11b19c101",
"certificate": "-----BEGIN CERTIFICATE-----\\n...\\n-----END CERTIFICATE-----\\n",
"private_key": "-----BEGIN PRIVATE KEY-----\\n...\\n-----END PRIVATE KEY-----\\n",
"expiry": 1742288230
}
}Bad Request — The request was malformed or contained invalid parameters. Check the error_msg field for details.
{
"value": {},
"error_msg": "error message"
}Not Found — The requested resource does not exist or has been deleted.
{
"value": {},
"error_msg": "error message"
}Complete operation details and schema variants
POST /api/ai_gateway_groups/{ai_gateway_group_id}/dp_client_certificates
Issue an AI data plane certificate
Issues a client mTLS certificate for an aisix-ee AI Gateway instance to authenticate with the control plane (dp-manager). Use this during aisix-ee bootstrap or certificate rotation.
Parameters
ai_gateway_group_id(path, string, required): AI Gateway group ID.
Responses
200: Data plane certificate issued successfully.- allOf variant 1
value(object, optional): The specific resource.- allOf variant 2
value(object, optional):value.id(string, optional): Certificate ID.value.certificate(string, optional): Certificate content.value.private_key(string, optional): Private key content.value.expiry(integer, optional): Expiration of the certificate.400: Bad Request — The request was malformed or contained invalid parameters. Check the error_msg field for details.value(object, optional): The specific resource.error_msg(string, optional): The error message.404: Not Found — The requested resource does not exist or has been deleted. Response fields (application/json): identical toPOST /api/ai_gateway_groups/{ai_gateway_group_id}/dp_client_certificates, response 400 above.
cURL
curl -X POST '$API_BASE_URL/api/ai_gateway_groups/{ai_gateway_group_id}/dp_client_certificates'