1. API
  2. Apps

Apps: Get

Last updated Open markdown version

Description

Retrieve a single app.

Request

HTTP Method: GET

Path Parameter Description
app_id The ID of the app to retrieve. 
curl -X GET \
  https://<tenant-domain>/api/v1/apps/<<app_id>> \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer <<CREDENTIAL.tines_api_key>>'

Response

A successful request will return a JSON object representing the specified app.

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

{
  "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 }
}
Was this helpful?