API Console
test
Sign in with BES

Service Account Create

Create a pending service account bound to one active product. Control gives it a service client of its own (`svc-<service_account_id>`), the product's `service` role and Control's `product-runtime` role, which grants the session and gateway validation calls and nothing else. The account cannot authenticate until `service-account.register` records its certificate and `service-account.set-status` activates it. Platform-level accounts (no product) are never created through this API. A caller bound to a product may only create accounts for that product.

POST https://id.test.globalbes.sg:9443/internal/control/v1/service-accounts
Called byBOSSPlatform ops AuthService certificate
Headers
uuid
Optional acting person; malformed UUID is denied.
Body
string
Caller supplied idempotency reference, 1 to 255 characters. The same reference with different parameters returns IDEMPOTENCY_CONFLICT.
uuid
The active product the account belongs to.
string
Display name of 1 to 200 characters; nonempty after trimming whitespace.
Sign in to sendBrowsing needs no sign-in
Request preview
POST /internal/control/v1/service-accounts
Response

Choose an API and send a request.

Caller tags:BOSSTenant adminAll productsMobile appMessagingControlAIAssistantPlatform opsLegacy productsCI release