Skip to main content

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

NameTypeRequiredDescription
account_idstrYes

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

NameTypeRequiredDescription
account_idstrYes

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

NameTypeRequiredDescription
bodyCreateServiceAccountRequestYes

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

NameTypeRequiredDescription
account_idstrYes
bodyRotateKeyRequestYes

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

NameTypeRequiredDescription
account_idstrYes

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

NameTypeRequiredDescription
account_idstrYes
bodyUpdateServiceAccountRequestYes

Example Request

curl -X PATCH "https://your-instance.datalinx.ai/api/api/service-accounts/{account_id}" \
-H "Authorization: Bearer YOUR_TOKEN"