Torii

App · 25 actions

Keep Torii, the SaaS management platform, in step with the rest of your work: update apps and their owners, track licenses and who uses each app, manage contracts and renewals, offboard people, import expenses and run Torii workflows. Start a workflow when an app is discovered, a contract nears its end, someone leaves or a Torii action fails.

Actions

ActionWhat it does
Add appAdd an app from Torii's catalog to your organization's apps, such as once a purchase is approved.
Create contractAdd a contract for an app, with its status, amount, dates and owner.
Delete contractDelete a contract from Torii for good.
Find appsFind the apps your organization uses, by words in their name or by state, with their owner and how many people use them.
Find contractsFind contracts by words, status or app, with their amount and dates.
Find expensesFind your organization's SaaS expenses, newest first, by app, words, dates or how they're matched to apps.
Find usersFind people in your organization by email, name or lifecycle status, with how many apps they use.
Get appGet an app's details: its state, category, owner, how many people use it and where Torii found it.
Get app licensesGet how many of an app's licenses are in use, inactive or unassigned, what they cost a year and what the unused ones could save, in all and by license type.
Get contractGet a contract's details: its app, status, owner, amount and dates.
Get expense importCheck whether Torii has finished reading an expense file, and how many of its expenses it matched to apps.
Get userGet a person's details: their lifecycle status, role, other emails and how many apps they use.
Import expense fileUpload a CSV or Excel file of expenses (up to 3 MB) and have Torii read it and match each expense to an app.
List app usersList the people who use an app, with their status in it, when they last used it and their licenses.
List audit logList what admins and Torii's automation did in your organization, such as changing a contract or signing in, newest first.
List fieldsList the fields apps, contracts or users have, your organization's own included, with the key other steps take and each dropdown's choices.
List user appsList the apps a person uses, or was removed from, with when they last used each.
List workflow action runsList what Torii workflows' actions did, newest first, and whether each finished or failed, such as to check on a workflow you started.
List workflowsList your organization's Torii workflows, with what starts each and whether it's turned on.
Mark user removed from appRecord in Torii that a person was removed from an app, such as once their account there is closed during offboarding, or undo that.
Run workflowStart a Torii workflow, with the app, person or contract its trigger is about.
Search app catalogFind apps in Torii's catalog by name, to add one to your organization or set up a contract for it.
Update appChange an app's details, such as moving it to Sanctioned or Closed, giving it an owner, or filling in your own fields.
Update contractChange a contract, such as its status or end date when it renews.
Update user lifecycle statusSet where a person is in their time at the organization: Active, Offboarding or Offboarded.

Add app

Add an app from Torii's catalog to your organization's apps, such as once a purchase is approved. Torii's API can't remove it again.

Inputs

Catalog appcatalog_apptextRequired
The app's ID in Torii's catalog, from 'Search app catalog'.

Outputs

active_usersnumber
How many people use it
categorytext
Its category, such as Developer Tools
created_attext
When it was added to Torii (ISO 8601)
custom_fieldsobject
The values of the fields asked for under More fields, by their key, as Torii gives them
descriptiontext
What it is
idnumber
The app's ID in Torii
image_urltext
A link to its logo
is_customtrue/false
True if it was added as a custom app
is_hiddentrue/false
True if it's hidden in Torii
last_visit_attext
When someone last used it (ISO 8601)
nametext
Its name
primary_owner_emailtext
Its primary owner's email
primary_owner_idnumber
Its primary owner's user ID; 0 if none
primary_owner_nametext
Its primary owner's name
sourceslist
Where Torii found it, such as google or okta
statetext
Its state, such as discovered or sanctioned
tagslist
Its tags
urltext
Its website
vendortext
Who makes it
Example output
{
  "active_users": 25,
  "category": "Developer Tools",
  "created_at": "2020-01-01T00:00:00.000Z",
  "custom_fields": {},
  "description": "Awesome application",
  "id": 1000,
  "image_url": "http://example.com/image.png",
  "is_custom": false,
  "is_hidden": false,
  "last_visit_at": "2026-11-05T00:00:00.000Z",
  "name": "Salesforce",
  "primary_owner_email": "tony@stark.com",
  "primary_owner_id": 1000,
  "primary_owner_name": "Tony Stark",
  "sources": [
    "okta"
  ],
  "state": "discovered",
  "tags": [
    "DevOps",
    "Human Resource"
  ],
  "url": "https://example.com",
  "vendor": "Salesforce"
}

Create contract

Add a contract for an app, with its status, amount, dates and owner. Fields your Torii admin made required must be filled in.

Inputs

NamenametextRequired
What the contract is called, such as Salesforce 2027.
AppapptextRequired
The app the contract is for, or its Torii ID.
StatusstatustextRequired
Its status, such as Active or In review.
Amountamountnumber
What the contract is worth, such as 12000.50.At least 0.
Currencycurrencytext
The amount's currency. Leave blank for your Torii currency.One of: USD (USD, US dollar), EUR (EUR, euro), GBP (GBP, British pound), CAD (CAD, Canadian dollar), AUD (AUD, Australian dollar), NZD (NZD, New Zealand dollar), JPY (JPY, Japanese yen), CHF (CHF, Swiss franc), SEK (SEK, Swedish krona), NOK (NOK, Norwegian krone), and 25 more.
Start datestart_datedate
When it starts.
End dateend_datedate
When it ends, which is when it renews.
Ownerownertext
Who owns it in your organization: their Torii user ID or email.
Custom fieldscustom_fieldsobject
Values for the contract's other fields, such as your organization's own. Fill in only what should change.

Outputs

amountnumber
What it's worth, such as 12000.50; 0 if not set
app_idnumber
The ID of the app it's for
created_attext
When it was added to Torii (ISO 8601)
currencytext
The amount's currency, such as USD
custom_fieldsobject
The values of the fields asked for under More fields, by their key, as Torii gives them
end_datetext
When it ends, which is when it renews (YYYY-MM-DD)
idnumber
The contract's ID in Torii
nametext
Its name
owner_idnumber
Its owner's user ID; 0 if none
start_datetext
When it starts (YYYY-MM-DD)
statustext
Its status, such as active or inReview
Example output
{
  "amount": 15000,
  "app_id": 1000,
  "created_at": "2026-02-01T09:00:00.000Z",
  "currency": "USD",
  "custom_fields": {},
  "end_date": "2027-02-02",
  "id": 1000,
  "name": "Salesforce contract",
  "owner_id": 1000,
  "start_date": "2026-02-03",
  "status": "active"
}

Delete contract

Delete a contract from Torii for good.

Inputs

ContractcontracttextRequired
The contract's Torii ID, from another Torii step or the trigger.

Outputs

deletedtrue/false
True once it's deleted
idnumber
The contract's ID
Example output
{
  "deleted": true,
  "id": 1000
}

Find apps

Find the apps your organization uses, by words in their name or by state, with their owner and how many people use them. Leave every field blank to list them all.

Inputs

Searchsearchtext
Words to look for, such as a name.
Statestatetext
Only apps in this state, such as Sanctioned.
Include licensesinclude_licensestrue/false
Also give each app's license counts and costs.
More fieldsmore_fieldslist
Other app fields to include, such as your organization's own. They come back under custom_fields.
How manylimitnumber
The most to list at once. Defaults to 50.From 1 to 1000.
Next pagecursortext
To get the next page, the next_cursor the step's last answer gave. Leave blank for the first page.

Outputs

appslist
The apps found
countnumber
How many are on this page
next_cursortext
Give this to the step's Next page field to get the next page; empty on the last page
totalnumber
How many match in all
Example output
{
  "apps": [
    {
      "active_users": 25,
      "category": "Developer Tools",
      "created_at": "2020-01-01T00:00:00.000Z",
      "custom_fields": {},
      "description": "Awesome application",
      "id": 1000,
      "image_url": "http://example.com/image.png",
      "is_custom": false,
      "is_hidden": false,
      "last_visit_at": "2026-11-05T00:00:00.000Z",
      "licenses": {
        "active": 80,
        "annual_cost": 120000,
        "currency": "USD",
        "inactive": 15,
        "potential_savings": 24000,
        "total": 100,
        "unassigned": 5
      },
      "name": "Salesforce",
      "primary_owner_email": "tony@stark.com",
      "primary_owner_id": 1000,
      "primary_owner_name": "Tony Stark",
      "sources": [
        "okta"
      ],
      "state": "discovered",
      "tags": [
        "DevOps",
        "Human Resource"
      ],
      "url": "https://example.com",
      "vendor": "Salesforce"
    }
  ],
  "count": 1,
  "next_cursor": "",
  "total": 1
}

Find contracts

Find contracts by words, status or app, with their amount and dates. Leave every field blank to list them all.

Inputs

Searchsearchtext
Words to look for, such as a name.
Statusstatustext
Only contracts with this status.
Appapptext
Only contracts for this app.
More fieldsmore_fieldslist
Other contract fields to include, such as your organization's own. They come back under custom_fields.
How manylimitnumber
The most to list at once. Defaults to 50.From 1 to 1000.
Next pagecursortext
To get the next page, the next_cursor the step's last answer gave. Leave blank for the first page.

Outputs

contractslist
The contracts found
countnumber
How many are on this page
next_cursortext
Give this to the step's Next page field to get the next page; empty on the last page
totalnumber
How many match in all
Example output
{
  "contracts": [
    {
      "amount": 15000,
      "app_id": 1000,
      "created_at": "2026-02-01T09:00:00.000Z",
      "currency": "USD",
      "custom_fields": {},
      "end_date": "2027-02-02",
      "id": 1000,
      "name": "Salesforce contract",
      "owner_id": 1000,
      "start_date": "2026-02-03",
      "status": "active"
    }
  ],
  "count": 1,
  "next_cursor": "",
  "total": 1
}

Find expenses

Find your organization's SaaS expenses, newest first, by app, words, dates or how they're matched to apps. Torii lists expenses matched to an app unless you choose otherwise.

Inputs

Appapptext
Only expenses for this app.
Searchsearchtext
Words in the expense's description.
Matchedstatuseslist
Only expenses matched this way. Leave blank for the ones matched to an app.One or more of: mapped (Matched to an app), unknown (Not matched), recommend_map (Suggested match), ignored, recommend_ignore (Suggested to ignore), archived.
Fromfrom_datedate
Only expenses on or after this day.
Untiluntil_datedate
Only expenses on or before this day.
How manylimitnumber
The most to list at once. Defaults to 50.From 1 to 1000.
Next pagecursortext
To get the next page, the next_cursor the step's last answer gave. Leave blank for the first page.

Outputs

countnumber
How many are on this page
next_cursortext
Give this to the step's Next page field to get the next page; empty on the last page
totalnumber
How many match in all
transactionslist
The expenses found
Example output
{
  "count": 1,
  "next_cursor": "",
  "total": 1,
  "transactions": [
    {
      "amount": 1300,
      "amount_in_org_currency": 1500,
      "app_id": 1000,
      "app_name": "Salesforce",
      "currency": "EUR",
      "date": "2022-02-03",
      "department": "Engineering",
      "description": "Salesforce subscription",
      "external_id": "INV-1001",
      "file_name": "expenses-q1.csv",
      "id": 1000,
      "reported_by_id": 1000,
      "reported_by_name": "Tony Stark",
      "source": "netsuite",
      "status": "mapped"
    }
  ]
}

Find users

Find people in your organization by email, name or lifecycle status, with how many apps they use. Leave every field blank to list them all.

Inputs

Emailemailtext
Their email.
Searchsearchtext
Words to look for, such as a name.
Lifecycle statuslifecycle_statustext
Only people at this point in their time at the organization.One of: active, offboarding, offboarded.
Left the organizationleft_organizationtrue/false
On for only people who have left, off for only those who haven't. Leave unset for both.
Externalexternaltrue/false
On for only people from outside the organization, off for only your own. Leave unset for both.
How manylimitnumber
The most to list at once. Defaults to 50.From 1 to 1000.
Next pagecursortext
To get the next page, the next_cursor the step's last answer gave. Leave blank for the first page.

Outputs

countnumber
How many are on this page
next_cursortext
Give this to the step's Next page field to get the next page; empty on the last page
totalnumber
How many match in all
userslist
The users found
Example output
{
  "count": 1,
  "next_cursor": "",
  "total": 1,
  "users": [
    {
      "active_apps": 12,
      "additional_emails": [],
      "created_at": "2020-01-01T00:00:00.000Z",
      "email": "tony@stark.com",
      "first_name": "Tony",
      "has_left": false,
      "id": 1000,
      "is_external": false,
      "last_name": "Stark",
      "lifecycle_status": "active",
      "name": "Tony Stark",
      "role": "Admin",
      "role_id": 1
    }
  ]
}

Get app

Get an app's details: its state, category, owner, how many people use it and where Torii found it.

Inputs

AppapptextRequired
The app, or its Torii ID.
More fieldsmore_fieldslist
Other app fields to include, such as your organization's own. They come back under custom_fields.

Outputs

active_usersnumber
How many people use it
categorytext
Its category, such as Developer Tools
created_attext
When it was added to Torii (ISO 8601)
custom_fieldsobject
The values of the fields asked for under More fields, by their key, as Torii gives them
descriptiontext
What it is
idnumber
The app's ID in Torii
image_urltext
A link to its logo
is_customtrue/false
True if it was added as a custom app
is_hiddentrue/false
True if it's hidden in Torii
last_visit_attext
When someone last used it (ISO 8601)
nametext
Its name
primary_owner_emailtext
Its primary owner's email
primary_owner_idnumber
Its primary owner's user ID; 0 if none
primary_owner_nametext
Its primary owner's name
sourceslist
Where Torii found it, such as google or okta
statetext
Its state, such as discovered or sanctioned
tagslist
Its tags
urltext
Its website
vendortext
Who makes it
Example output
{
  "active_users": 25,
  "category": "Developer Tools",
  "created_at": "2020-01-01T00:00:00.000Z",
  "custom_fields": {},
  "description": "Awesome application",
  "id": 1000,
  "image_url": "http://example.com/image.png",
  "is_custom": false,
  "is_hidden": false,
  "last_visit_at": "2026-11-05T00:00:00.000Z",
  "name": "Salesforce",
  "primary_owner_email": "tony@stark.com",
  "primary_owner_id": 1000,
  "primary_owner_name": "Tony Stark",
  "sources": [
    "okta"
  ],
  "state": "discovered",
  "tags": [
    "DevOps",
    "Human Resource"
  ],
  "url": "https://example.com",
  "vendor": "Salesforce"
}

Get app licenses

Get how many of an app's licenses are in use, inactive or unassigned, what they cost a year and what the unused ones could save, in all and by license type.

Inputs

AppapptextRequired
The app, or its Torii ID.

Outputs

activenumber
How many are in use
annual_costnumber
What the licenses cost a year, in your Torii currency
app_idnumber
The app's ID
app_nametext
Its name
currencytext
The currency of the costs, such as USD
inactivenumber
How many are assigned but not used
potential_savingsnumber
What a year of the inactive and unassigned licenses costs, in your Torii currency
totalnumber
How many licenses the app has
typeslist
Each license type, with its own counts and costs
unassignednumber
How many aren't assigned to anyone
Example output
{
  "active": 80,
  "annual_cost": 120000,
  "app_id": 1000,
  "app_name": "Salesforce",
  "currency": "USD",
  "inactive": 15,
  "potential_savings": 24000,
  "total": 100,
  "types": [
    {
      "active": 80,
      "annual_cost": 120000,
      "currency": "USD",
      "inactive": 15,
      "name": "Enterprise",
      "potential_savings": 24000,
      "price_per_license": 1200,
      "total": 100,
      "unassigned": 5
    }
  ],
  "unassigned": 5
}

Get contract

Get a contract's details: its app, status, owner, amount and dates.

Inputs

ContractcontracttextRequired
The contract's Torii ID, from another Torii step or the trigger.
More fieldsmore_fieldslist
Other contract fields to include, such as your organization's own. They come back under custom_fields.

Outputs

amountnumber
What it's worth, such as 12000.50; 0 if not set
app_idnumber
The ID of the app it's for
created_attext
When it was added to Torii (ISO 8601)
currencytext
The amount's currency, such as USD
custom_fieldsobject
The values of the fields asked for under More fields, by their key, as Torii gives them
end_datetext
When it ends, which is when it renews (YYYY-MM-DD)
idnumber
The contract's ID in Torii
nametext
Its name
owner_idnumber
Its owner's user ID; 0 if none
start_datetext
When it starts (YYYY-MM-DD)
statustext
Its status, such as active or inReview
Example output
{
  "amount": 15000,
  "app_id": 1000,
  "created_at": "2026-02-01T09:00:00.000Z",
  "currency": "USD",
  "custom_fields": {},
  "end_date": "2027-02-02",
  "id": 1000,
  "name": "Salesforce contract",
  "owner_id": 1000,
  "start_date": "2026-02-03",
  "status": "active"
}

Get expense import

Check whether Torii has finished reading an expense file, and how many of its expenses it matched to apps.

Inputs

Importimport_idtextRequired
The import's ID, from 'Import expense file'.

Outputs

donetrue/false
True once Torii has finished reading the file
file_idnumber
The uploaded file's ID; 0 when only checking an import
import_idnumber
The import's ID, which 'Get expense import' takes
matchednumber
How many expenses Torii matched to apps
statustext
parsing_in_progress, parsed_successfully or parsing_failed, as Torii reports it
succeededtrue/false
True if Torii read the file successfully
totalnumber
How many expenses the file has
Example output
{
  "done": true,
  "file_id": 1000,
  "import_id": 1000,
  "matched": 55,
  "status": "parsed_successfully",
  "succeeded": true,
  "total": 60
}

Get user

Get a person's details: their lifecycle status, role, other emails and how many apps they use.

Inputs

UserusertextRequired
The person's Torii user ID, from another Torii step or the trigger, or their email.

Outputs

active_appsnumber
How many apps they use
additional_emailslist
Their other emails
created_attext
When Torii first saw them (ISO 8601)
emailtext
Their email
first_nametext
Their first name
has_lefttrue/false
True if they've left the organization (removed from its identity source)
idnumber
The user's ID in Torii
is_externaltrue/false
True if they're from outside the organization
last_nametext
Their last name
lifecycle_statustext
active, offboarding or offboarded
nametext
Their full name
roletext
Their role in Torii, such as Admin
role_idnumber
Their role's ID; 0 if none
Example output
{
  "active_apps": 12,
  "additional_emails": [],
  "created_at": "2020-01-01T00:00:00.000Z",
  "email": "tony@stark.com",
  "first_name": "Tony",
  "has_left": false,
  "id": 1000,
  "is_external": false,
  "last_name": "Stark",
  "lifecycle_status": "active",
  "name": "Tony Stark",
  "role": "Admin",
  "role_id": 1
}

Import expense file

Upload a CSV or Excel file of expenses (up to 3 MB) and have Torii read it and match each expense to an app. Torii's API can't remove the expenses again.

Inputs

Expense filefiletextRequired
A CSV, TSV or Excel file of expenses, with a date, a description and an amount on each row.

Outputs

donetrue/false
True once Torii has finished reading the file
file_idnumber
The uploaded file's ID; 0 when only checking an import
import_idnumber
The import's ID, which 'Get expense import' takes
matchednumber
How many expenses Torii matched to apps
statustext
parsing_in_progress, parsed_successfully or parsing_failed, as Torii reports it
succeededtrue/false
True if Torii read the file successfully
totalnumber
How many expenses the file has
Example output
{
  "done": true,
  "file_id": 1000,
  "import_id": 1000,
  "matched": 55,
  "status": "parsed_successfully",
  "succeeded": true,
  "total": 60
}

List app users

List the people who use an app, with their status in it, when they last used it and their licenses.

Inputs

AppapptextRequired
The app, or its Torii ID.
Statusstatustext
Only people with this status in the app.One of: active, deleted, managed.
Searchsearchtext
Words to look for, such as a name.
How manylimitnumber
The most to list at once. Defaults to 50.From 1 to 1000.
Next pagecursortext
To get the next page, the next_cursor the step's last answer gave. Leave blank for the first page.

Outputs

countnumber
How many are on this page
next_cursortext
Give this to the step's Next page field to get the next page; empty on the last page
totalnumber
How many match in all
userslist
The app's users
Example output
{
  "count": 1,
  "next_cursor": "",
  "total": 1,
  "users": [
    {
      "account_name": "demo-torii",
      "email": "admin@demo-torii.com",
      "external_status": "active",
      "first_name": "Torii",
      "has_left": false,
      "id": 873786409,
      "inactive_licenses": 1,
      "last_name": "Demo",
      "last_visit_at": "2021-08-31T00:00:00.000Z",
      "licenses": [
        {
          "last_used_at": "2021-06-30T01:34:43.000Z",
          "name": "Jira Software",
          "paid": true,
          "status": "active",
          "usage": "inactive"
        }
      ],
      "lifecycle_status": "active",
      "name": "Torii Demo",
      "removed_from_app": false,
      "roles": [],
      "sources": [
        "atlassian",
        "google"
      ],
      "status": "active"
    }
  ]
}

List audit log

List what admins and Torii's automation did in your organization, such as changing a contract or signing in, newest first.

Inputs

Aboutentitytext
Only events about this. Leave blank for all.One of: apps, contracts, users, licenses, workflows, tasks, transactions (Expenses), integrations, authentication (Sign-ins), access, and 18 more.
Fromstart_datedate
Only events after this day.
Untilend_datedate
Only events up to the end of this day.
Orderordertext
Newest or oldest first.One of: desc (Newest first), asc (Oldest first). Default: desc.
How manylimitnumber
The most to list at once. Defaults to 50.From 1 to 1000.
Next pagecursortext
To get the next page, the next_cursor the step's last answer gave. Leave blank for the first page.

Outputs

countnumber
How many are on this page
eventslist
The audit log events, newest first unless asked
next_cursortext
Give this to the step's Next page field to get the next page; empty on the last page
Example output
{
  "count": 1,
  "events": [
    {
      "by_automation": false,
      "method": "put",
      "path": "/api/orgs/10/contracts/50000",
      "performed_by_email": "tony@stark.com",
      "performed_by_id": 1000,
      "performed_by_name": "Tony Stark",
      "properties": {},
      "time": "2020-01-01T00:00:00.000Z",
      "type": "update_contract"
    }
  ],
  "next_cursor": ""
}

List fields

List the fields apps, contracts or users have, your organization's own included, with the key other steps take and each dropdown's choices.

Inputs

Fields ofrecord_typetextRequired
Which kind of record's fields to list.One of: apps, contracts, users.

Outputs

countnumber
How many are listed
fieldslist
The fields
Example output
{
  "count": 1,
  "fields": [
    {
      "id": 1000,
      "key": "planName",
      "name": "Plan Name",
      "options": [
        {
          "label": "In-Review",
          "value": "inReview"
        }
      ],
      "type": "dropdown"
    }
  ]
}

List user apps

List the apps a person uses, or was removed from, with when they last used each.

Inputs

UserusertextRequired
The person's Torii user ID, from another Torii step or the trigger, or their email.
App statestatetext
Only apps in this state, such as Sanctioned.
Removedremovedtrue/false
On for only apps they were removed from, off for only the ones they still have. Leave unset for both.

Outputs

appslist
The person's apps
countnumber
How many are listed
Example output
{
  "apps": [
    {
      "category": "Developer Tools",
      "id": 1000,
      "last_used_at": "2026-11-05T00:00:00.000Z",
      "name": "Salesforce",
      "removed_from_app": false,
      "sources": [
        "okta"
      ],
      "state": "discovered",
      "url": "https://example.com"
    }
  ],
  "count": 1
}

List workflow action runs

List what Torii workflows' actions did, newest first, and whether each finished or failed, such as to check on a workflow you started.

Inputs

Appapptext
Only actions on this app.
Userusertext
Only actions on this person: their Torii user ID or email.
How manylimitnumber
The most to list at once. Defaults to 50.From 1 to 1000.
Next pagecursortext
To get the next page, the next_cursor the step's last answer gave. Leave blank for the first page.

Outputs

countnumber
How many are on this page
next_cursortext
Give this to the step's Next page field to get the next page; empty on the last page
runslist
The action runs
totalnumber
How many match in all
Example output
{
  "count": 1,
  "next_cursor": "",
  "runs": [
    {
      "action_id": "3873472394983",
      "action_type": "actionOnUser",
      "app_id": 1000,
      "completed": true,
      "completed_at": "2022-02-03T00:05:00Z",
      "created_at": "2022-02-03T00:00:00Z",
      "details": {
        "userAlreadyExists": true
      },
      "error_at": "",
      "error_type": "",
      "failed": false,
      "id": 1000,
      "ignored": false,
      "workflow_id": 1000,
      "workflow_run_id": 2
    }
  ],
  "total": 1
}

List workflows

List your organization's Torii workflows, with what starts each and whether it's turned on.

Inputs

None.

Outputs

countnumber
How many are listed
workflowslist
The workflows
Example output
{
  "count": 1,
  "workflows": [
    {
      "app_id": 0,
      "created_at": "2026-01-05",
      "id": 1000,
      "is_active": true,
      "is_valid": true,
      "last_triggered_at": "2026-11-05",
      "name": "Slack new app notification",
      "trigger_type": "newApp"
    }
  ]
}

Mark user removed from app

Record in Torii that a person was removed from an app, such as once their account there is closed during offboarding, or undo that.

Inputs

UserusertextRequired
The person's Torii user ID, from another Torii step or the trigger, or their email.
AppapptextRequired
The app, or its Torii ID.
Removedremovedtrue/false
On to mark them removed from the app; off to mark them back in it.Default: true.

Outputs

categorytext
Its category
idnumber
The app's ID in Torii
last_used_attext
When the user last used it (ISO 8601)
nametext
Its name
removed_from_apptrue/false
True if the user was marked removed from it
sourceslist
Where Torii saw them use it
statetext
Its state, such as sanctioned
urltext
Its website
user_idnumber
The user's ID
Example output
{
  "category": "Developer Tools",
  "id": 1000,
  "last_used_at": "2026-11-05T00:00:00.000Z",
  "name": "Salesforce",
  "removed_from_app": false,
  "sources": [
    "okta"
  ],
  "state": "discovered",
  "url": "https://example.com",
  "user_id": 1000
}

Run workflow

Start a Torii workflow, with the app, person or contract its trigger is about. It does whatever the workflow does, such as offboarding someone or messaging an owner.

Inputs

WorkflowworkflowtextRequired
The Torii workflow, or its ID.
Appapptext
The app it's about, for a workflow started by an app, such as New app discovered.
User emailuser_emailtext
The person it's about, for a workflow started by a person, such as User left.
Contractcontracttext
The contract's Torii ID, for a workflow started by a contract.
Licenselicense_nametext
The license it's about, such as Pro, for a License not in use workflow. Give the App too.
Webhook datapayloadobject
For a workflow started by a Custom trigger (Webhook), the fields of its sample payload, such as days: 30.

Outputs

startedtrue/false
True once Torii has started the workflow
workflow_idnumber
The workflow's ID
Example output
{
  "started": true,
  "workflow_id": 1000
}

Search app catalog

Find apps in Torii's catalog by name, to add one to your organization or set up a contract for it.

Inputs

NamequerytextRequired
Words in the app's name, such as Salesforce.
How manylimitnumber
The most to list at once. Defaults to 10.From 1 to 50.

Outputs

appslist
The catalog apps found
countnumber
How many are listed
Example output
{
  "apps": [
    {
      "category": "Developer Tools",
      "id": 1000,
      "image_url": "http://example.com/image.png",
      "name": "Salesforce",
      "url": "https://example.com"
    }
  ],
  "count": 1
}

Update app

Change an app's details, such as moving it to Sanctioned or Closed, giving it an owner, or filling in your own fields. Fields left blank keep what they have.

Inputs

AppapptextRequired
The app, or its Torii ID.
Namenametext
A new name. Leave blank to keep it.
Statestatetext
Its new state, such as Sanctioned or Closed.
Primary ownerownertext
Who owns the app: their Torii user ID or email.
Categorycategorytext
Its category, such as Sales.
Websiteurltext
Its website.
Descriptiondescriptiontext
What it is.
Tagstagstext
Its tags, separated by commas, such as DevOps, Finance. They replace the tags it has.
Hiddenhiddentrue/false
Hide the app in Torii, or show it again.
Custom fieldscustom_fieldsobject
Values for the app's other fields, such as your organization's own. Fill in only what should change.

Outputs

active_usersnumber
How many people use it
categorytext
Its category, such as Developer Tools
created_attext
When it was added to Torii (ISO 8601)
custom_fieldsobject
The values of the fields asked for under More fields, by their key, as Torii gives them
descriptiontext
What it is
idnumber
The app's ID in Torii
image_urltext
A link to its logo
is_customtrue/false
True if it was added as a custom app
is_hiddentrue/false
True if it's hidden in Torii
last_visit_attext
When someone last used it (ISO 8601)
nametext
Its name
primary_owner_emailtext
Its primary owner's email
primary_owner_idnumber
Its primary owner's user ID; 0 if none
primary_owner_nametext
Its primary owner's name
sourceslist
Where Torii found it, such as google or okta
statetext
Its state, such as discovered or sanctioned
tagslist
Its tags
urltext
Its website
vendortext
Who makes it
Example output
{
  "active_users": 25,
  "category": "Developer Tools",
  "created_at": "2020-01-01T00:00:00.000Z",
  "custom_fields": {},
  "description": "Awesome application",
  "id": 1000,
  "image_url": "http://example.com/image.png",
  "is_custom": false,
  "is_hidden": false,
  "last_visit_at": "2026-11-05T00:00:00.000Z",
  "name": "Salesforce",
  "primary_owner_email": "tony@stark.com",
  "primary_owner_id": 1000,
  "primary_owner_name": "Tony Stark",
  "sources": [
    "okta"
  ],
  "state": "discovered",
  "tags": [
    "DevOps",
    "Human Resource"
  ],
  "url": "https://example.com",
  "vendor": "Salesforce"
}

Update contract

Change a contract, such as its status or end date when it renews. Fields left blank keep what they have.

Inputs

ContractcontracttextRequired
The contract's Torii ID, from another Torii step or the trigger.
Namenametext
A new name. Leave blank to keep it.
Appapptext
Move it to another app. Leave blank to keep it.
Statusstatustext
A new status. Leave blank to keep it.
Amountamountnumber
What the contract is worth, such as 12000.50.At least 0.
Currencycurrencytext
The amount's currency. Leave blank for your Torii currency.One of: USD (USD, US dollar), EUR (EUR, euro), GBP (GBP, British pound), CAD (CAD, Canadian dollar), AUD (AUD, Australian dollar), NZD (NZD, New Zealand dollar), JPY (JPY, Japanese yen), CHF (CHF, Swiss franc), SEK (SEK, Swedish krona), NOK (NOK, Norwegian krone), and 25 more.
Start datestart_datedate
When it starts.
End dateend_datedate
When it ends, which is when it renews.
Ownerownertext
Who owns it in your organization: their Torii user ID or email.
Custom fieldscustom_fieldsobject
Values for the contract's other fields, such as your organization's own. Fill in only what should change.

Outputs

amountnumber
What it's worth, such as 12000.50; 0 if not set
app_idnumber
The ID of the app it's for
created_attext
When it was added to Torii (ISO 8601)
currencytext
The amount's currency, such as USD
custom_fieldsobject
The values of the fields asked for under More fields, by their key, as Torii gives them
end_datetext
When it ends, which is when it renews (YYYY-MM-DD)
idnumber
The contract's ID in Torii
nametext
Its name
owner_idnumber
Its owner's user ID; 0 if none
start_datetext
When it starts (YYYY-MM-DD)
statustext
Its status, such as active or inReview
Example output
{
  "amount": 15000,
  "app_id": 1000,
  "created_at": "2026-02-01T09:00:00.000Z",
  "currency": "USD",
  "custom_fields": {},
  "end_date": "2027-02-02",
  "id": 1000,
  "name": "Salesforce contract",
  "owner_id": 1000,
  "start_date": "2026-02-03",
  "status": "active"
}

Update user lifecycle status

Set where a person is in their time at the organization: Active, Offboarding or Offboarded. Offboarded, for someone whose offboarding is under way, marks their remaining apps done and completes their open offboarding tasks.

Inputs

UserusertextRequired
The person's Torii user ID, from another Torii step or the trigger, or their email.
Lifecycle statuslifecycle_statustextRequired
Where they are now.One of: active, offboarding, offboarded.

Outputs

active_appsnumber
How many apps they use
additional_emailslist
Their other emails
created_attext
When Torii first saw them (ISO 8601)
emailtext
Their email
first_nametext
Their first name
has_lefttrue/false
True if they've left the organization (removed from its identity source)
idnumber
The user's ID in Torii
is_externaltrue/false
True if they're from outside the organization
last_nametext
Their last name
lifecycle_statustext
active, offboarding or offboarded
nametext
Their full name
roletext
Their role in Torii, such as Admin
role_idnumber
Their role's ID; 0 if none
Example output
{
  "active_apps": 12,
  "additional_emails": [],
  "created_at": "2020-01-01T00:00:00.000Z",
  "email": "tony@stark.com",
  "first_name": "Tony",
  "has_left": false,
  "id": 1000,
  "is_external": false,
  "last_name": "Stark",
  "lifecycle_status": "active",
  "name": "Tony Stark",
  "role": "Admin",
  "role_id": 1
}

On this page