Skip to content

API Tara: browsing ​

Explore resources and view their details

This page is generated from openapi.yaml by npm run gen, so do not edit it by hand. Authentication is described on the overview page.

GET/v1/resources

Search resources

Parameters ​

NameInTypeRequiredDescription
qquerystringKeyword in the name
kindqueryskill | agent | kit | prompt | harness
orgquerystringSlug of the owning organization
channelqueryofficial | org | user | communityRelease channel
minequerybooleanOnly my community resources (including private)
rolequerystringMatching role
statusqueryactive | deprecated
sortquerypopular | recent | name
limitqueryinteger
offsetqueryinteger

Responses ​

CodeDescriptionType
200Search resultsapplication/json · object
400Invalid inputapplication/problem+json · object
401Not signed inapplication/problem+json · object

Example response ​

json
{
  "items": [
    {
      "name": "agent-ba",
      "displayName": "PhillipCLI Business Analyst Agent",
      "kind": "skill",
      "org": "aiforge",
      "ownerType": "user",
      "channel": "official",
      "visibility": "private",
      "status": "active",
      "description": "string",
      "keywords": [],
      "roles": [],
      "downloads": 0
    }
  ],
  "total": 0,
  "limit": 0,
  "offset": 0
}

Call with curl ​

bash
curl "https://tara.phillipcli.cloud/v1/resources" \
  -H "Authorization: Bearer $TARA_TOKEN"
GET/v1/resources/{name}

Resource details and installable versions

Parameters ​

NameInTypeRequiredDescription
namepathstringyes
orgquerystringSlug of the owning organization (full name <org>/<name>). Omitted: {name} means aiforge/<name>, then the caller's own organization, never another organization (a public community resource of another organization is reachable only by its full name; a miss that matches one answers 404 with code not_found_hint listing up to 5 full names)

Responses ​

CodeDescriptionType
200Resource detailsapplication/json · object + object
401Not signed inapplication/problem+json · object
404Not foundapplication/problem+json · object

Example response ​

json
{
  "name": "agent-ba",
  "displayName": "PhillipCLI Business Analyst Agent",
  "kind": "skill",
  "org": "aiforge",
  "ownerType": "user",
  "channel": "official",
  "visibility": "private",
  "status": "active",
  "description": "string",
  "keywords": [
    "string"
  ],
  "roles": [
    "string"
  ],
  "downloads": 0,
  "versions": [
    {
      "id": "string",
      "version": "1.2.0",
      "state": "submitted",
      "publishedAt": "2026-11-01T00:00:00Z"
    }
  ],
  "contributions": [
    {
      "org": "acme",
      "name": "string",
      "fullName": "acme/skill-notes",
      "version": "1.0.0",
      "latestVersion": "1.0.0"
    }
  ]
}

Call with curl ​

bash
curl "https://tara.phillipcli.cloud/v1/resources/<name>" \
  -H "Authorization: Bearer $TARA_TOKEN"
POST/v1/resources/{name}/reports

Report a resource (suspected malware, deception, data leak…); Tara immediately rescans every version still in use

Parameters ​

NameInTypeRequiredDescription
namepathstringyes
orgquerystringSlug of the owning organization (full name <org>/<name>). Omitted: {name} means aiforge/<name>, then the caller's own organization, never another organization (a public community resource of another organization is reachable only by its full name; a miss that matches one answers 404 with code not_found_hint listing up to 5 full names)

Body (application/json) ​

FieldTypeRequiredDescription
reasonstringyes

Responses ​

CodeDescriptionType
204Report received
400Invalid inputapplication/problem+json · object
401Not signed inapplication/problem+json · object
404Not foundapplication/problem+json · object
409Already reported and pendingapplication/problem+json · object

Call with curl ​

bash
curl -X POST "https://tara.phillipcli.cloud/v1/resources/<name>/reports" \
  -H "Authorization: Bearer $TARA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"reason":"string"}'
GET/v1/resources/{name}/stats

Download statistics by day and by version

Parameters ​

NameInTypeRequiredDescription
namepathstringyes
orgquerystringSlug of the owning organization (full name <org>/<name>). Omitted: {name} means aiforge/<name>, then the caller's own organization, never another organization (a public community resource of another organization is reachable only by its full name; a miss that matches one answers 404 with code not_found_hint listing up to 5 full names)
daysqueryintegerMost recent days

Responses ​

CodeDescriptionType
200Statisticsapplication/json · object
401Not signed inapplication/problem+json · object
404Not foundapplication/problem+json · object

Example response ​

json
{
  "days": [
    {
      "day": "string",
      "count": 0
    }
  ],
  "versions": [
    {
      "version": "string",
      "count": 0
    }
  ],
  "usage": {
    "sessions": 0,
    "users": 0,
    "sessionCostUsd": 0,
    "directCostUsd": 0
  }
}

Call with curl ​

bash
curl "https://tara.phillipcli.cloud/v1/resources/<name>/stats" \
  -H "Authorization: Bearer $TARA_TOKEN"
GET/v1/models

Model catalog approved by the platform

Visible to everyone who is signed in. status: active is an approved model (selectable); deprecated is being phased out. task is the purpose: reasoning (reasoning, design, review), code (code generation), light (quick tasks). recommended marks the default suggested model for that purpose. ph model list|use reads this endpoint.

Responses ​

CodeDescriptionType
200List of modelsapplication/json · object
401Not signed inapplication/problem+json · object

Example response ​

json
{
  "items": [
    {
      "alias": "opus-review",
      "engine": "claude-code",
      "model": "claude-opus-5-5",
      "task": "reasoning",
      "purpose": "string",
      "roles": [],
      "status": "active",
      "recommended": false
    }
  ]
}

Call with curl ​

bash
curl "https://tara.phillipcli.cloud/v1/models" \
  -H "Authorization: Bearer $TARA_TOKEN"