Skip to main content
PATCH
/
api
/
apps
/
v1
/
{id}
Update selected details of an application
curl --request PATCH \
  --url https://app.trelica.com/api/apps/v1/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "instanceName": "EMEA Sales",
  "status": "Accepted"
}
'
{
  "id": "9425963fcd38ed972d209b49",
  "name": "Asana",
  "status": "New",
  "riskLevel": "High",
  "vendor": {
    "id": "f7f213984a1a225358c21c71",
    "name": "Asana, Inc."
  },
  "licenses": [
    {
      "name": "Premium",
      "licensePlanId": "PREMIUM",
      "startDate": "2024-07-22T00:00:00Z",
      "renewalDate": "2025-07-22T00:00:00Z",
      "terminatedDate": "2025-10-22T00:00:00Z",
      "lastModifiedDtm": "2024-11-27T16:00:20.895Z"
    },
    {
      "name": "Business",
      "licensePlanId": "BUSINESS",
      "startDate": "2021-06-22T00:00:00Z",
      "renewalDate": "2022-06-22T00:00:00Z",
      "lastModifiedDtm": "2023-05-15T12:28:57.137Z"
    }
  ],
  "customFields": {
    "user_area": "support",
    "user_vcc": "corp_support"
  },
  "deleted": false,
  "roles": [
    {
      "name": "IT admin",
      "members": [
        {
          "userId": "20fcf665630fc6562182578cb7f19f1e",
          "name": "Eduardo Wilson",
          "email": "eduardo.wilson@example.com"
        }
      ]
    },
    {
      "name": "App owner",
      "members": [
        {
          "userId": "0372c6f6fc51bc128389337de1146143",
          "name": "Eduardo Jung",
          "email": "eduardo.jung@example.com"
        }
      ]
    }
  ],
  "isGlobal": false,
  "mainCategory": {
    "id": "03823a9d2e817efcce22f52e",
    "name": "Project Management"
  },
  "otherCategories": [
    {
      "id": "cab66910ac7cc93acdcc0338",
      "name": "Project Management & Tracking"
    },
    {
      "id": "22d0532b27e33b61e53a6fc5",
      "name": "Team Coordination & Comms"
    },
    {
      "id": "74e38311e5ad68ef2ab9dbb2",
      "name": "Task Management"
    }
  ],
  "logoUrl": "https://app-files.trelica.com/public/4ad42e9e68cf46e3bc59cb8eab35886c",
  "links": {
    "application": "https://app.asana.com/"
  }
}

Authorizations

​
Authorization
string
header
required

OAuth 2.0. Obtain an access token via the Client Credentials or Authorization Code flow, then send it as Authorization: Bearer <token>.

Path Parameters

​
id
string
required

The application's SaaS Manager ID.

Body

application/json

Selected application fields to update. Omitted fields are left unchanged; fields set to null are cleared.

​
instanceName
string | null

The instance name, used to distinguish multiple instances of the same application

​
status
enum<string> | null

The application's status, e.g. New, InReview, Managed, Accepted, Ignored, PlanToClose, Closed

Available options:
New,
InReview,
Managed,
Accepted,
Ignored,
PlanToClose,
Closed
​
roles
object[] | null

Replace the application's owner roles. Members are matched by ID, email or name.

​
customFields
object

Custom field values to set, keyed by the field's lookup key

Response

OK

An application

​
id
string

The application's unique ID

​
name
string

The application name

​
description
string

A description of the application

​
instanceName
string

The instance name, used to distinguish multiple instances of the same application

​
status
enum<string>

The application's status in SaaS Manager.

Available options:
New,
InReview,
Managed,
Accepted,
Ignored,
PlanToClose,
Closed
​
riskLevel
string

Optional OAuth access risk level: Low, Medium or High

​
vendor
object

The application's vendor

​
licenses
object[]

The application's license plans

​
customFields
object

Custom field values, keyed by the field's lookup key. Each value is the field's value directly: a string (text/single-select), a number, an ISO-8601 date, or an array of strings (multi-select).

​
createdBy
object

The user that created the application record

​
createdDtm
string<date-time>

The timestamp for when the application record was created

​
deleted
boolean

Whether the application has been deleted

​
lastModifiedDtm
string<date-time>

The timestamp for when the application record was last modified

​
roles
object[]

The application's owner roles and their members

​
isGlobal
boolean

Whether the application is recognised in the global application catalog

​
mainCategory
object

The application's primary category

​
otherCategories
object[]

The application's additional categories

​
domains
string[]

The application's domains

​
logoUrl
string

A URL for the application's logo

​
signOnUrl
string

The application's single sign-on URL

​
links
object

Links to pages containing application details