API Tara: browsing
Explore resources and view their details
This page is generated from
openapi.yamlbynpm run gen, so do not edit it by hand. Authentication is described on the overview page.
/v1/resourcesSearch resources
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
q | query | string | Keyword in the name | |
kind | query | skill | agent | kit | prompt | harness | ||
org | query | string | Slug of the owning organization | |
channel | query | official | org | user | community | Release channel | |
mine | query | boolean | Only my community resources (including private) | |
role | query | string | Matching role | |
status | query | active | deprecated | ||
sort | query | popular | recent | name | ||
limit | query | integer | ||
offset | query | integer |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | Search results | application/json · object |
| 400 | Invalid input | application/problem+json · object |
| 401 | Not signed in | application/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"/v1/resources/{name}Resource details and installable versions
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | yes | |
org | query | string | Slug 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
| Code | Description | Type |
|---|---|---|
| 200 | Resource details | application/json · object + object |
| 401 | Not signed in | application/problem+json · object |
| 404 | Not found | application/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"/v1/resources/{name}/reportsReport a resource (suspected malware, deception, data leak…); Tara immediately rescans every version still in use
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | yes | |
org | query | string | Slug 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)
| Field | Type | Required | Description |
|---|---|---|---|
reason | string | yes |
Responses
| Code | Description | Type |
|---|---|---|
| 204 | Report received | |
| 400 | Invalid input | application/problem+json · object |
| 401 | Not signed in | application/problem+json · object |
| 404 | Not found | application/problem+json · object |
| 409 | Already reported and pending | application/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"}'/v1/resources/{name}/statsDownload statistics by day and by version
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | yes | |
org | query | string | Slug 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) | |
days | query | integer | Most recent days |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | Statistics | application/json · object |
| 401 | Not signed in | application/problem+json · object |
| 404 | Not found | application/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"/v1/modelsModel 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
| Code | Description | Type |
|---|---|---|
| 200 | List of models | application/json · object |
| 401 | Not signed in | application/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"