1. API
  2. Apps

Apps: List

Last updated Open markdown version

Description

Retrieve a list of apps visible to the authenticated user.

Request

HTTP Method: GET

Query Parameter Description
per_page Optional Set the number of results returned per page. Defaults to 20.
page Optional Specify the page of results to return if there are multiple pages. Defaults to page 1. 
curl -X GET \
  https://<tenant-domain>/api/v1/apps \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>'

Response

A successful request will return a JSON object containing an array of apps visible to the authenticated user.

Field description

Parameter Description
id The app ID.
guid Unique identifier of the app.
name The app name.
description A user-defined description of the app.
emoji The emoji associated with the app.
created_at ISO 8601 timestamp representing date and time the app was created.
updated_at ISO 8601 timestamp representing date and time the app was last updated.
team Object containing the id and name of the team the app belongs to.
published_version Object containing the id of the published version, or null if the app has not been published.

Sample response

{
  "apps": [
    {
      "id": 42,
      "guid": "abc123def456",
      "name": "Phishing triage",
      "description": "Triages reported phishing emails.",
      "emoji": "📧",
      "created_at": "2026-05-14T10:00:00Z",
      "updated_at": "2026-05-14T11:30:00Z",
      "team": { "id": 7, "name": "Security" },
      "published_version": { "id": 101 }
    }
  ],
  "meta": {
    "current_page": "https://<tenant-domain>/api/v1/apps?per_page=20&page=1",
    "previous_page": null,
    "next_page": null,
    "next_page_number": null,
    "per_page": 20,
    "pages": 1,
    "count": 1
  }
}
Was this helpful?