Service Accounts API
Auto-generated from codebase analysis
This section documents the Service Accounts API endpoints.
GET Endpoints
GET /api/service-accounts
List all service accounts for the current tenant
Required Permissions: org.admin
Example Request
curl -X GET "https://your-instance.datalinx.ai/api/api/service-accounts" \
-H "Authorization: Bearer YOUR_TOKEN"
GET /api/service-accounts/{account_id}
Get a specific service account
Required Permissions: org.admin
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
account_id | str | Yes |
Example Request
curl -X GET "https://your-instance.datalinx.ai/api/api/service-accounts/{account_id}" \
-H "Authorization: Bearer YOUR_TOKEN"
GET /api/service-accounts/{account_id}/api-key-info
Get API key information for a service account (without revealing the full key).
Required Permissions: org.admin
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
account_id | str | Yes |
Example Request
curl -X GET "https://your-instance.datalinx.ai/api/api/service-accounts/{account_id}/api-key-info" \
-H "Authorization: Bearer YOUR_TOKEN"
POST Endpoints
POST /api/service-accounts
Create a new service account.
Required Permissions: org.admin
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
body | CreateServiceAccountRequest | Yes |
Example Request
curl -X POST "https://your-instance.datalinx.ai/api/api/service-accounts" \
-H "Authorization: Bearer YOUR_TOKEN"
POST /api/service-accounts/{account_id}/rotate-key
Rotate the API key for a service account.
Required Permissions: org.admin
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
account_id | str | Yes | |
body | RotateKeyRequest | Yes |
Example Request
curl -X POST "https://your-instance.datalinx.ai/api/api/service-accounts/{account_id}/rotate-key" \
-H "Authorization: Bearer YOUR_TOKEN"
DELETE Endpoints
DELETE /api/service-accounts/{account_id}
Delete a service account
Required Permissions: org.admin
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
account_id | str | Yes |
Example Request
curl -X DELETE "https://your-instance.datalinx.ai/api/api/service-accounts/{account_id}" \
-H "Authorization: Bearer YOUR_TOKEN"
PATCH Endpoints
PATCH /api/service-accounts/{account_id}
Update a service account
Required Permissions: org.admin
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
account_id | str | Yes | |
body | UpdateServiceAccountRequest | Yes |
Example Request
curl -X PATCH "https://your-instance.datalinx.ai/api/api/service-accounts/{account_id}" \
-H "Authorization: Bearer YOUR_TOKEN"