Skip to main content

ServiceAccountDto

A platform service account as seen by a client: a non-human account that belongs to the network. Its role/membership_status come from the companion network-member record. Internal fields (version, info, created_by) are not exposed.

idstring

The service account id

Example: 7Hb2Kp9QvL3mNx0R8tZ4
namestring

Human-readable label

Example: billing-sync
descriptionstringnullable

Optional free-text description of what the account is used for

Example: Automated nightly billing reconciliation
statusstring

Account status

Possible values: [active, disabled]

Example: active
rolestring

Network role held by the account

Possible values: [admin, viewer]

Example: viewer
membership_statusstring

Membership status

Possible values: [active, pending, suspended]

Example: active
network_urlstring

Link to the owning network

Example: https://api.adbridge.ai/external/v1/networks/7Hb2Kp9QvL3mNx0R8tZ4
created_atdate-time

When the account was created

Example: 2026-01-15T09:30:00Z
updated_atdate-time

When the account was last updated

Example: 2026-01-15T09:30:00Z
ServiceAccountDto
{
  "id": "7Hb2Kp9QvL3mNx0R8tZ4",
  "name": "billing-sync",
  "description": "Automated nightly billing reconciliation",
  "status": "active",
  "role": "viewer",
  "membership_status": "active",
  "network_url": "https://api.adbridge.ai/external/v1/networks/7Hb2Kp9QvL3mNx0R8tZ4",
  "created_at": "2026-01-15T09:30:00Z",
  "updated_at": "2026-01-15T09:30:00Z"
}