Renew device certificate (disabled)

POST

/api/v1/devices/{deviceId}/certificates/{certificateId}/renew

curl --request POST \
  --url http://localhost:3000/api/v1/devices/550e8400-e29b-41d4-a716-446655440000/certificates/550e8400-e29b-41d4-a716-446655440001/renew \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "validityDays": 365 }'

• Development
• Production

Device certificate renewal is currently disabled and always fails with 409 Conflict. A renewed certificate has to reach the device, and Margo v1.0.0-rc2 defines no mechanism to deliver one (tracked as FM-1318). The device keeps presenting the certificate it onboarded with; the stored validity always reflects that certificate.

Authorizations

• api-key
• bearer

Parameters

Path Parameters

deviceId

required

string format: uuid

Example

550e8400-e29b-41d4-a716-446655440000

Device UUID

certificateId

required

string format: uuid

Example

550e8400-e29b-41d4-a716-446655440001

Certificate UUID

Header Parameters

x-organization-id

string format: uuid

UUID of the organization (tenant) the request acts in. It selects the tenant and grants nothing: the server checks membership or an open tenant switch. Not needed for global operations. A malformed value returns 400. API keys are fixed to their own organization; another organization returns 403. The x-organization-source header grants nothing.

Request Body^required

Media typeapplication/json

object

validityDays

Ignored. Device certificate renewal is disabled and always fails with 409 (FM-1318).

number

default: 365 >= 1 <= 3650

Example

365

Responses

400

Bad Request - Invalid path parameter or request body

401

Unauthorized - Invalid or missing authentication

403

Forbidden - Insufficient permissions (operator or admin)

409

Conflict - Device certificate renewal is disabled: Margo v1.0.0-rc2 defines no mechanism to deliver a renewed certificate to the device (FM-1318).