GET /v1/organizations/{org_id}/projects/{id}

Every monitoring stack, CVE alert and EOL subscription is attached to a project. Project IDs are obtained by walking the hierarchy from your organizations: see GET /v1/organizations.

Project details

GET /api/v1/organizations/{org_id}/projects/{project_id}
Authorization: Bearer twa_your_key_here

Path parameters

Parameter	Type	Description
org_id	UUID	Organization identifier
project_id	UUID	Project identifier

Response 200 OK

{
  "id": "018e1234-abcd-7000-8000-000000000010",
  "name": "Prod infrastructure",
  "description": "Production servers and dependencies",
  "org_id": "018e5678-abcd-7000-8000-000000000001",
  "is_default": true,
  "created_at": "2024-03-15T10:22:00Z"
}

Fields

Field	Type	Description
id	string (UUID)	Project identifier — used in every /organizations/{org_id}/projects/{id}/... endpoint
name	string	Project name
description	string | null	Description (null if not set)
org_id	string (UUID) | null	Organization the project belongs to
is_default	boolean	true for the project created automatically at signup
created_at	string (ISO 8601)	Creation date

Errors

Code	Detail	Cause
404	Projet introuvable	project_id does not exist
403	Accès refusé à ce projet	Project exists but you are neither owner nor member

---

Examples

Store the default project ID of the personal organization

PERSONAL_ORG=$(curl -s \
  -H "Authorization: Bearer twa_your_key_here" \
  https://app.techwatchalert.com/api/v1/organizations \
  | jq -r '.[] | select(.is_personal == true) | .id')

DEFAULT_PROJECT=$(curl -s \
  -H "Authorization: Bearer twa_your_key_here" \
  "https://app.techwatchalert.com/api/v1/organizations/${PERSONAL_ORG}/projects" \
  | jq -r '.[] | select(.is_default == true) | .id')

echo "Default project: $DEFAULT_PROJECT"