Account

Account configuration collection manages system-wide account settings including naming, descriptions, timezone settings, and redirection URLs for multi-tenant system operations.

The account Object

Account collection stores fundamental account configuration data that defines account identity, regional settings, and default redirection behavior within the TrackVision system.

Field Name	Type	Description
id	uuid	Primary key. Unique identifier for the account (UUID format).
user_created	object	Unique identifier of the user who created the account record.
date_created	datetime	Timestamp in ISO8601 when the account record was created.
user_updated	object	Unique identifier of the user who last updated the account record.
date_updated	datetime	Timestamp in ISO8601 when the account record was last updated.
account_name	string	Display name for the account used in system interfaces and reporting.
account_description	string	Optional detailed description of the account and its purpose.
timezone	string	Default timezone setting for the account, references timezone collection.
account_redirection_url	string	"Last resort" default URL for Digital Link redirections when no other more specific redirection rules apply.

---

List Accounts

List existing accounts.

REST

GET /items/account

GraphQL

query {
  account {
    id
    account_name
    account_description
    timezone
    account_redirection_url
    date_created
    date_updated
  }
}

Query Parameters

Supports all global query parameters.

Returns

An array of up to limit account objects. If no items are available, data will be an empty array.

---

Retrieve an Account

Retrieve a specific account by ID.

REST

GET /items/account/:id

GraphQL

query {
  account_by_id(id: "account_id") {
    id
    account_name
    account_description
    timezone
    account_redirection_url
    user_created {
      id
      first_name
      last_name
    }
    date_created
    user_updated {
      id
      first_name
      last_name
    }
    date_updated
  }
}

Returns

Returns an account object if a valid primary key was provided.

---

Create an Account

Create a new account.

REST

POST /items/account

{
  "account_name": "TrackVision Enterprise",
  "account_description": "Enterprise account for comprehensive TV analytics",
  "timezone": "America/New_York",
  "account_redirection_url": "https://enterprise.trackvision.ai"
}

GraphQL

mutation {
  create_account_item(data: {
    account_name: "TrackVision Enterprise"
    account_description: "Enterprise account for comprehensive TV analytics"
    timezone: "America/New_York"
    account_redirection_url: "https://enterprise.trackvision.ai"
  }) {
    id
    account_name
    account_description
    timezone
    account_redirection_url
  }
}

Query Parameters

Supports all global query parameters.

Request Body

A partial account object.

Returns

Returns the account object for the created account.

---

Update an Account

Update an existing account.

REST

PATCH /items/account/:id

{
  "account_name": "TrackVision Enterprise - Updated",
  "account_description": "Updated enterprise account for comprehensive TV analytics",
  "timezone": "America/Los_Angeles"
}

GraphQL

mutation {
  update_account_item(id: "account_id", data: {
    account_name: "TrackVision Enterprise - Updated"
    account_description: "Updated enterprise account for comprehensive TV analytics"
    timezone: "America/Los_Angeles"
  }) {
    id
    account_name
    account_description
    timezone
  }
}

Query Parameters

Supports all global query parameters.

Request Body

A partial account object.

Returns

Returns the account object for the updated account.

---

Delete an Account

Delete an existing account.

REST

DELETE /items/account/:id

GraphQL

mutation {
  delete_account_item(id: "account_id") {
    id
  }
}

Returns

Empty body.

---

Sample Data

ID	Account Name	Timezone	Account Redirection URL
9146cd19-ce38-4369-8834-02287ba1ad1b	Default - Rename	null	https://www.trackvision.ai