Client rotate secret
POST /client/{id}/rotate-secret
Rotate an OAuth client secret
Authorization
bearer AuthorizationBearer <token>
In: header
Path Parameters
id*string
Internal client UUID (the id field returned by client list / detail endpoints, NOT the public clientId).
Response Body
application/json
application/json
application/json
curl -X POST "https://api.part3.io/v1/client/4f5e6d7c-8b9a-4d2e-a3f5-678c9d0e1f2a/rotate-secret"{
"id": "4f5e6d7c-8b9a-4d2e-a3f5-678c9d0e1f2a",
"clientId": "p3_8a1b2c3d4e5f60718293a4b5c6d7e8f9",
"name": "AcmeCorp Project Sync",
"description": "Backend job that mirrors AcmeCorp project metadata into our PM system.",
"superadmin": false,
"enabled": true,
"createdBy": "admin@part3.io",
"createdAt": "2026-01-08T19:24:00Z",
"permissions": {
"mcp:access": true,
"organization:read": true,
"project:read": true,
"document:read": true,
"email:read": true,
"client:read": false,
"client:create": false,
"explorer:query": false
},
"usageSummary": {
"totalRequests": 14280,
"endpoints": [
{
"endpoint": "GET /v1/document",
"count": 8421,
"averageResponseTimeMs": 142.18
}
]
},
"scopes": {
"orgs": [
{
"orgId": "org_8a1b2c3d4e",
"grantedAt": "2026-01-08T19:25:00Z"
}
],
"projects": [
{
"orgId": "org_8a1b2c3d4e",
"projectId": "proj_5f9a3c2e8b",
"grantedAt": "2026-01-08T19:25:00Z"
}
]
},
"client_secret": "Hkz7-Yv9e0pQqRlKxX3a8mB9NfTuWvYzCdEgHjKmL_M"
}{
"error": "Client token required"
}{
"error": "Client token required"
}