For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.

Skip to navigation

Sare Core API Identity

Delete Role

||View as Markdown|

DELETE

http://localhost:8080/api/v3/roles/:id

DELETE

/api/v3/roles/:id

curl -X DELETE http://localhost:8080/api/v3/roles/e4c0c3d4-6b7a-4c8d-9e0f-1a2b3c4d5e6f \
     -H "Authorization: Bearer {{accessToken}}" \
     -H "X-Device-Id: {{deviceId}}" \
     -H "X-Request-Id: {{requestId}}" \
     -H "X-Signature: {{signature}}" \
     -H "X-Timestamp: {{timestamp}}"

Path parameters

idstringRequired

Headers

AuthorizationstringOptional

X-Device-IdstringOptional

Required on non-GET requests to non-public paths (DeviceSignatureFilter), skipped for GET/whitelisted/multipart requests and in the local profile.

X-SignaturestringOptional

Base64 ECDSA signature over sha256(body) + timestamp + requestId, signed with the device's registered private key.

X-TimestampstringOptional

Unix epoch seconds; must be within 5 minutes of server time.

X-Request-IdstringOptional

Unique per request - reused values are rejected as replays.

Response

204 No Content

Errors

400

Bad Request Error

Was this page helpful?

List Permission Groups

Sare Core API