Skip to content
TriedDocs
Integrations

Get app

Read one integration app with its status, mock flag, masked credentials and actions.

GEThttps://api.tried.com.au/get-app/{id}

Returns one integration app. Use it to check status and mock before an agent relies on the app.

Request#

Path parameter Type Required Description
id string Yes The app_id, for example app_6f1c2a9e4b7d3058a1e2c4f9.

Example request#

curl https://api.tried.com.au/get-app/app_6f1c2a9e4b7d3058a1e2c4f9 \
  -H "Authorization: Bearer $TRIED_API_KEY"
const res = await fetch("https://api.tried.com.au/get-app/app_6f1c2a9e4b7d3058a1e2c4f9", {
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const app = await res.json();
import os, requests

res = requests.get(
    "https://api.tried.com.au/get-app/app_6f1c2a9e4b7d3058a1e2c4f9",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
)
app = res.json()

Response#

200 OK

{
  "app_id": "app_3d9a7e1f5c2b8046d7e9a1c3",
  "app_type": "hubspot",
  "name": "HubSpot AU",
  "status": "connected",
  "mock": false,
  "credentials": {
    "access_token": "******e4a1",
    "refresh_token": "******9b0d",
    "expires_at": "1792393600000",
    "token_type": "Bearer",
    "oauth": "1",
    "oauth_provider": "hubspot"
  },
  "required_credentials": ["access_token"],
  "config": {},
  "actions": ["hubspot.create_contact", "hubspot.create_note"],
  "created_timestamp": 1792390000000,
  "last_modification_timestamp": 1792390000000
}

This example app was connected with Start OAuth, so its credentials include the token expiry and oauth markers. See Create app for the field table.

Errors#

Status When
401 Missing or invalid API key.
403 The key's IP allowlist or scopes reject the request. This route needs the admin scope.
404 App <id> not found in this workspace.
429 Rate limit exceeded. See Rate limits.

See Errors for the body format.

Retell compatibility#

Same path and method as Retell (/get-app/{app_id}). The response shape differs: see Create app.