Class Profile

Constructors

constructor

new Profile(params: GenericModuleParams): Profile
Parameters
- params: GenericModuleParams
Returns Profile
Inherited from TagoIOModule<GenericModuleParams>.constructor
- Defined in common/TagoIOModule.ts:75

Methods

addonEdit

addonEdit(profileID: string, addonObj: Partial<AddonInfo>): Promise<string>
Updates the add-on configuration for a profile.
Parameters
- profileID: string
- addonObj: Partial<AddonInfo>
Returns Promise<string>
Deprecated
This route is deprecated.
- Defined in modules/Resources/Profile.ts:271

addonList

addonList(profileID: string): Promise<AddonInfo>
Retrieves a list of all add-ons associated with the profile.
Parameters
- profileID: string
Returns Promise<AddonInfo>
Deprecated
This route is deprecated.
- Defined in modules/Resources/Profile.ts:257

addTeamMember

addTeamMember(id: string, email: string): Promise<string>
Adds a new team member to the profile using their email address.
Parameters
- id: string
- email: string
Returns Promise<string>
See
https://help.tago.io/portal/en/kb/articles/106-sharing-your-profile Team Management - Sharing your Profile
Example
```
const resources = new Resources({ token: "YOUR-PROFILE-TOKEN" });
const result = await resources.profiles.addTeamMember("profile-id-123", "user@example.com");
console.log(result); // User invited
```
- Defined in modules/Resources/Profile.ts:425

auditLog

auditLog(profileID: string, filterObj?: AuditLogFilter): Promise<AuditLog>
Creates a new audit log query for tracking profile activities.
Parameters
- profileID: string
- OptionalfilterObj: AuditLogFilter
Returns Promise<AuditLog>
See
https://help.tago.io/portal/en/kb/articles/audit-log Audit Log
Example
```
const resources = new Resources({ token: "YOUR-PROFILE-TOKEN" });
const result = await resources.profiles.auditLog("profile-id-123", {
  start_date: new Date("2024-12-01"),
  end_date: new Date("2024-12-07")
});
console.log(result);
```
- Defined in modules/Resources/Profile.ts:219

auditLogQuery

auditLogQuery(profileID: string, queryId?: string): Promise<AuditLog>
Retrieves audit log entries using a previously created query.
Parameters
- profileID: string
- OptionalqueryId: string
Returns Promise<AuditLog>
See
https://help.tago.io/portal/en/kb/articles/audit-log Audit Log
Example
```
const resources = new Resources({ token: "YOUR-PROFILE-TOKEN" });
const result = await Resources.profiles.auditLogQuery("profile-id-123", "query-id-456");
console.log(result);
```
- Defined in modules/Resources/Profile.ts:242

create

create(
profileObj: { name: string },
options?: { allocate_free_resources?: boolean },
): Promise<{ id: string }>
Creates a new profile with the specified name and optional resource allocation settings.
Parameters
- profileObj: { name: string }
- Optionaloptions: { allocate_free_resources?: boolean }
Returns Promise<{ id: string }>
See
https://help.tago.io/portal/en/kb/articles/198-profiles#Adding_Profiles Adding Profiles
Example
```
const resources = new Resources({ token: "YOUR-PROFILE-TOKEN" });
const result = await resources.profiles.create({ name: "New Profile" }, { allocate_free_resources: true });
console.log(result); // { id: 'profile-id-123' }
```
- Defined in modules/Resources/Profile.ts:109

delete

delete(
profileID: string,
credentials: { password: string; pin_code?: string },
): Promise<string>
Permanently removes a profile from the account.
Parameters
- profileID: string
- credentials: { password: string; pin_code?: string }
Returns Promise<string>
See
https://help.tago.io/portal/en/kb/articles/526-two-factor-authentication Two-Factor Authentication (2FA)
Example
```
const resources = new Resources({ token: "YOUR-PROFILE-TOKEN" });
// The “pin_code” field is required when 2FA is activated
const result = await resources.profiles.delete("profile-id-123", { password: "your-password", pin_code: "123456" });
console.log(result); // Successfully Removed
```
- Defined in modules/Resources/Profile.ts:163

deleteTeamMember

deleteTeamMember(id: string, accountId: string): Promise<string>
Removes a team member from the profile.
Parameters
- id: string
- accountId: string
Returns Promise<string>
See
https://help.tago.io/portal/en/kb/articles/106-sharing-your-profile Team Management - Sharing your Profile
Example
If receive an error "Authorization Denied", check policy in Access Management.
```
const resources = new Resources({ token: "YOUR-PROFILE-TOKEN" });
const result = await resources.profiles.deleteTeamMember("profile-id-123", "account-id-456");
console.log(result); // Account Successfully Removed
```
- Defined in modules/Resources/Profile.ts:471

edit

edit(profileID: string, profileObj: Partial<ProfileInfo>): Promise<string>
Updates profile information with the provided data.
Parameters
- profileID: string
- profileObj: Partial<ProfileInfo>
Returns Promise<string>
See
https://help.tago.io/portal/en/kb/articles/198-profiles#Renaming_your_Profiles Renaming your Profiles
Example
```
const resources = new Resources({ token: "YOUR-PROFILE-TOKEN" });
const result = await resources.profiles.edit("profile-id-123", { name: "Updated Profile Name" });
console.log(result); // Successfully Updated
```
- Defined in modules/Resources/Profile.ts:140

info

info(profileID: string): Promise<ProfileInfo>
Retrieves detailed information about a specific profile using its ID or 'current' for the active profile.
Parameters
- profileID: string
Returns Promise<ProfileInfo>
See
https://help.tago.io/portal/en/kb/articles/198-profiles Profiles
Example
If receive an error "Authorization Denied", check policy Account / Access profile in Access Management.
```
const profileInfo = await Resources.profiles.info("profile-id-123");
// Or get current profile
const currentProfile = await Resources.profiles.info("current");
console.log(profileInfo); // { info { id: 'profile-id-123', account: 'account-id-123', ...}, ... }
```
- Defined in modules/Resources/Profile.ts:62

list

list(): Promise<ProfileListInfo[]>
Retrieves a list of all profiles associated with the current account.

Returns Promise<ProfileListInfo[]>
See
https://help.tago.io/portal/en/kb/articles/198-profiles Profiles
Example
If receive an error "Authorization Denied", check policy Account / Access profile in Access Management.
```
const result = await Resources.profiles.list();
console.log(result); // [ { id: 'profile-id-123', name: 'Profile Test', ... } ]
```
- Defined in modules/Resources/Profile.ts:39

removeAddOn

removeAddOn(profileId: string, addon: BillingAddOn): Promise<string>
Removes an add-on from the profile at the end of the current billing cycle.
Parameters
- profileId: string
- addon: BillingAddOn
Returns Promise<string>
Deprecated
This route is deprecated.
- Defined in modules/Resources/Profile.ts:404

serviceEdit

serviceEdit(profileID: string, serviceObj: object): Promise<string>
Updates service configuration and resource limits for a profile.
Parameters
- profileID: string
- serviceObj: object
Returns Promise<string>
- Defined in modules/Resources/Profile.ts:284

summary

summary(
profileID: string,
options?: { onlyAmount?: boolean },
): Promise<ProfileSummary>
Retrieves a summary of the profile's usage and statistics.
Parameters
- profileID: string
- Optionaloptions: { onlyAmount?: boolean }
Returns Promise<ProfileSummary>
See
https://help.tago.io/portal/en/kb/articles/198-profiles Profiles
Example
If receive an error "Authorization Denied", check policy Account / Access profile in Access Management.
```
const result = await Resources.profiles.summary("profile-id-123");
console.log(result); // { amount: { device: 10, bucket: 10, dashboard: 5, ... }, ... }
```
- Defined in modules/Resources/Profile.ts:85

teamList

teamList(id: string): Promise<ProfileTeam[]>
Retrieves a list of all team members that have access to the specified profile.
Parameters
- id: string
Returns Promise<ProfileTeam[]>
See
https://help.tago.io/portal/en/kb/articles/106-sharing-your-profile Team Management - Sharing your Profile
Example
```
const resources = new Resources({ token: "YOUR-PROFILE-TOKEN" });
const result = await resources.profiles.teamList("profile-id-123");
console.log(result); // [ { id: 'account-id-123', active: false, name: 'John Doe', ... }, ... ]
```
- Defined in modules/Resources/Profile.ts:449

tokenCreate

tokenCreate(
profileID: string,
tokenParams: TokenData & Authenticator,
): Promise<TokenCreateResponse>
Creates a new authentication token for the specified profile.
Parameters
- profileID: string
- tokenParams: TokenData & Authenticator
Returns Promise<TokenCreateResponse>
See
- https://help.tago.io/portal/en/kb/articles/495-account-token Account Token
- https://help.tago.io/portal/en/kb/articles/526-two-factor-authentication Two-Factor Authentication (2FA)
Example
```
const resources = new Resources({ token: "YOUR-PROFILE-TOKEN" });
// The “pin_code” / "otp_type" field is required when 2FA is activated
const result = await resources.profiles.tokenCreate("profile-id-123", {
  name: "API Access",
  permission: "full",
  email: "example@email.com",
  password: "your-password"
 });
console.log(result); // { token: 'token-value', name: 'API Access', ... }
```
- Defined in modules/Resources/Profile.ts:366

tokenDelete

tokenDelete(profileId: string, token: string): Promise<string>
Revokes and removes an authentication token from the profile.
Parameters
- profileId: string
- token: string
Returns Promise<string>
See
https://help.tago.io/portal/en/kb/articles/495-account-token Account Token
Example
```
const resources = new Resources({ token: "YOUR-PROFILE-TOKEN" });
const result = await resources.profiles.tokenDelete("profile-id-123", "token-xyz");
console.log(result); // Token Successfully Removed
```
- Defined in modules/Resources/Profile.ts:390

tokenList

tokenList(
profileID: string,
queryObj?: ListTokenQuery,
): Promise<Partial<TokenDataList>[]>
Retrieves a list of all tokens associated with a specific profile.
Parameters
- profileID: string
- OptionalqueryObj: ListTokenQuery
Returns Promise<Partial<TokenDataList>[]>
See
https://help.tago.io/portal/en/kb/articles/495-account-token Account Token
Example
```
const resources = new Resources({ token: "YOUR-PROFILE-TOKEN" });
const result = await resources.profiles.tokenList("profile-id-123", {
  page: 1,
  amount: 20,
  fields: ["name", "token", "permission"]
});
console.log(result); // [ { name: 'Token #1', token: 'token-value', permission: 'full', ... }, ... ]
```
- Defined in modules/Resources/Profile.ts:329

transferTokenToAnotherProfile

transferTokenToAnotherProfile(targetProfileID: string): Promise<string>
Transfers the current authentication token to another profile.
Parameters
- targetProfileID: string
Returns Promise<string>
Example
```
const resources = new Resources({ token: "YOUR-PROFILE-TOKEN" });
const result = await resources.profiles.transferTokenToAnotherProfile("target-profile-123");
console.log(result);
```
- Defined in modules/Resources/Profile.ts:304

usageStatisticList

usageStatisticList(
profileID: string,
dateObj?: StatisticsDate,
): Promise<UsageStatistic[]>
Retrieves usage statistics for a profile within a specified time period.

Usage statistics are cumulative: if a service was not used in a time period, the statistics for that time period will not be in the object.
Parameters
- profileID: string
- OptionaldateObj: StatisticsDate
Returns Promise<UsageStatistic[]>
Example
If receive an error "Authorization Denied", check policy Account / Access profile statistics in Access Management.
```
const result = await Resources.profiles.usageStatisticList("profile-id-123", {
  start_date: "2024-09-01",
  end_date: "2024-12-31",
  periodicity: "day"
});
console.log(result); // [ { time: '2024-09-02T00:01:29.749Z', analysis: 0.07, data_records: 67254, ... }, ... ]
```
- Defined in modules/Resources/Profile.ts:190

Class Profile

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns Profile

Methods

addonEdit

Parameters

Returns Promise<string>

Deprecated

addonList

Parameters

Returns Promise<AddonInfo>

Deprecated

addTeamMember

Parameters

Returns Promise<string>

See

Example

auditLog

Parameters

Returns Promise<AuditLog>

See

Example

auditLogQuery

Parameters

Returns Promise<AuditLog>

See

Example

create

Parameters

Returns Promise<{ id: string }>

See

Example

delete

Parameters

Returns Promise<string>

See

Example

deleteTeamMember

Parameters

Returns Promise<string>

See

Example

edit

Parameters

Returns Promise<string>

See

Example

info

Parameters

Returns Promise<ProfileInfo>

See

Example

list

Returns Promise<ProfileListInfo[]>

See

Example

removeAddOn

Parameters

Returns Promise<string>

Deprecated

serviceEdit

Parameters

Returns Promise<string>

summary

Parameters

Returns Promise<ProfileSummary>

See

Example

teamList

Parameters

Returns Promise<ProfileTeam[]>

See

Example

tokenCreate

Parameters