Sign in

v1

latestOpenAPI 3.0.3Apache 2.02026-07-2685172326.0 KB
Service Accounts

Create a service account

Create a service account with optional initial role bindings; the client secret is returned only once.

post/admin/service-accounts

Headers

X-Pinecone-Api-Versionstring required

Required date-based version header

Request body

namestring required

The human-readable name of the service account.

Example request

{
  "name": "ci-prod",
  "role_bindings": [
    {
      "resource_type": "project",
      "role": "ProjectOwner"
    }
  ]
}

Response

Service account created. Role bindings are not returned here; use GET /admin/role-bindings to list them.

client_secretstring required

The OAuth client secret. Returned exactly once. Treat this value as a credential — store it securely and never log it.

Example response

{
  "client_secret": "8p-kkC23XOWvkCosKq-BOn3G74qp__rBcDMxc82iB4gfzRvuhSCRBKM7C5Q7TAzj",
  "service_account": {
    "client_id": "l3Ow0CmFyc4jOONcwiKUCRqQKN0tiCAn",
    "created_at": "2026-04-10T15:23:00.000Z",
    "id": "f8a3b2c1-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
    "name": "My Service Account",
    "updated_at": "2026-04-10T15:23:00.000Z"
  }
}