API Tara: publishing
Submit resources, view submissions and versions
This page is generated from
openapi.yamlbynpm run gen, so do not edit it by hand. Authentication is described on the overview page.
/v1/resources/{name}/visibilityAdminChange a resource's visibility (private or internal to public and back)
Personal resources are private or public (owner only); organization resources are internal or public (organization owner or admin). Making a resource public rescans every installable version with the community rules (no executable components, scanner, model review); errors keep it as it was (409). You cannot close a public resource again once another public resource depends on it, or once it is pinned in a project lock (409). Signatures of installable versions are re-issued because the channel changes.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | yes | |
org | query | string | Slug of the owner (full name <owner>/<name>); omitted: the current organization's resource, then your personal one |
Body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
visibility | private | internal | public | yes | private (personal resources) is visible and installable only by the owner; internal (organization resources) by every member of the organization, viewers included; public by every PhillipCLI user, labeled Community. official resources are always public. A personal resource is private or public, an organization resource internal or public. |
Responses
| Code | Description | Type |
|---|---|---|
| 204 | Visibility changed | |
| 400 | Invalid input | application/problem+json · object |
| 401 | Not signed in | application/problem+json · object |
| 403 | Forbidden | application/problem+json · object |
| 404 | Not found | application/problem+json · object |
| 409 | Conflict | application/problem+json · object |
Call with curl
curl -X PUT "https://tara.phillipcli.cloud/v1/resources/<name>/visibility" \
-H "Authorization: Bearer $TARA_TOKEN" \
-H "Content-Type: application/json" \
-d '{"visibility":"private"}'/v1/resources/{name}/contributeContribute a personal resource to an organization (copy, no review)
Copies the latest released version of one of your personal resources to <org>/<name> (internal), records who contributed it and where it came from, signs it for the organization and releases it immediately. The publish policy of the organization applies (member or admin; viewers never). Contributing again copies a newer version into the same organization resource. 409 if the name is taken by something else.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | path | string | yes | |
org | query | string | Your own namespace, when {name} is given as part of a full name; optional |
Body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
org | string | yes | Slug of the target organization (you must be a member) |
Responses
| Code | Description | Type |
|---|---|---|
| 201 | Contributed | application/json · object |
| 400 | Invalid input | application/problem+json · object |
| 401 | Not signed in | application/problem+json · object |
| 403 | Forbidden | application/problem+json · object |
| 404 | Not found | application/problem+json · object |
| 409 | Conflict | application/problem+json · object |
Example response
{
"org": "string",
"name": "string",
"fullName": "acme/skill-notes",
"version": "string",
"contributedBy": "string",
"sourceName": "an/skill-notes"
}Call with curl
curl -X POST "https://tara.phillipcli.cloud/v1/resources/<name>/contribute" \
-H "Authorization: Bearer $TARA_TOKEN" \
-H "Content-Type: application/json" \
-d '{"org":"string"}'/v1/submissions/previewCheck a package before submitting (nothing is saved)
Body (multipart/form-data)
| Field | Type | Required | Description |
|---|---|---|---|
package | string (binary) | yes | Zip file of the resource folder (up to 50 MiB) |
owner | string | Publish to this owner (your own handle, an organization slug, or aiforge); overrides metadata.forge.org. Absent: the manifest decides, no org in the manifest means your personal store. | |
visibility | private | internal | public | private (personal resources) is visible and installable only by the owner; internal (organization resources) by every member of the organization, viewers included; public by every PhillipCLI user, labeled Community. official resources are always public. A personal resource is private or public, an organization resource internal or public. |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | Check results and package contents | application/json · object |
| 400 | Invalid input | application/problem+json · object |
| 401 | Not signed in | application/problem+json · object |
Example response
{
"manifest": {
"name": "string",
"displayName": "string",
"version": "string",
"description": "string",
"roles": [
"string"
],
"keywords": [
"string"
]
},
"readme": "string",
"changelog": "string",
"files": [
{
"path": "string",
"size": 0,
"sha256": "string",
"executable": false
}
],
"findings": [
{
"rule": "string",
"level": "malware",
"path": "string",
"message": "string"
}
],
"canPublish": false,
"hasErrors": false
}Call with curl
curl -X POST "https://tara.phillipcli.cloud/v1/submissions/preview" \
-H "Authorization: Bearer $TARA_TOKEN" \
-F "package=<package>" \
-F "owner=<owner>" \
-F "visibility=<visibility>"/v1/submissionsMy submissions
Returns the caller's own submissions. Organizations have no review queue, and the official catalog review is not part of this API.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
scope | query | mine |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | List of submissions | application/json · object |
| 401 | Not signed in | application/problem+json · object |
| 403 | Forbidden | application/problem+json · object |
Example response
{
"items": [
{
"id": "string",
"name": "string",
"kind": "skill",
"org": "string",
"channel": "official",
"visibility": "private",
"version": "string",
"displayName": "string",
"state": "submitted",
"stateReason": "string",
"submittedBy": "string",
"submittedAt": "2026-11-01T00:00:00Z",
"errorCount": 0,
"warningCount": 0,
"executableCount": 0
}
]
}Call with curl
curl "https://tara.phillipcli.cloud/v1/submissions" \
-H "Authorization: Bearer $TARA_TOKEN"/v1/submissionsPublish a resource version (checks run, then it is released)
The owner is owner (form field) or metadata.forge.org: aiforge is the official catalog (platform staff submit, reviewed by platform staff); an organization slug publishes into that organization (allowed by its publish policy: members, or admins only; viewers never), internal by default; absent (or your own handle) is your personal store, private by default. There is no review for personal and organization stores: a version that passes the automatic scanner is released immediately and signed. Executable components are allowed except for public resources. visibility applies to a new resource (public needs the owner, or an organization owner or admin) and must match an existing one. The legacy metadata.forge.center is still read (rnd is aiforge, another value is the current organization) with a deprecation warning. Full resource name: <owner>/<name>.
Body (multipart/form-data)
| Field | Type | Required | Description |
|---|---|---|---|
package | string (binary) | yes | Zip file of the resource folder (up to 50 MiB) |
owner | string | Publish to this owner (your own handle, an organization slug, or aiforge); overrides metadata.forge.org. Absent: the manifest decides, no org in the manifest means your personal store. | |
visibility | private | internal | public | private (personal resources) is visible and installable only by the owner; internal (organization resources) by every member of the organization, viewers included; public by every PhillipCLI user, labeled Community. official resources are always public. A personal resource is private or public, an organization resource internal or public. |
Responses
| Code | Description | Type |
|---|---|---|
| 201 | Submission received; automatic checks run in the background | application/json · object |
| 400 | Invalid input | application/problem+json · object |
| 401 | Not signed in | application/problem+json · object |
| 403 | Forbidden | application/problem+json · object |
| 409 | Conflict | application/problem+json · object |
Example response
{
"id": "string",
"name": "string",
"kind": "skill",
"org": "string",
"channel": "official",
"visibility": "private",
"version": "string",
"displayName": "string",
"state": "submitted",
"stateReason": "string",
"submittedBy": "string",
"submittedAt": "2026-11-01T00:00:00Z",
"errorCount": 0,
"warningCount": 0,
"executableCount": 0
}Call with curl
curl -X POST "https://tara.phillipcli.cloud/v1/submissions" \
-H "Authorization: Bearer $TARA_TOKEN" \
-F "package=<package>" \
-F "owner=<owner>" \
-F "visibility=<visibility>"/v1/versions/{id}Details of a version (a submission or a released version)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | yes |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | Version details | application/json · object + object |
| 401 | Not signed in | application/problem+json · object |
| 404 | Not found | application/problem+json · object |
Example response
{
"id": "string",
"name": "string",
"kind": "skill",
"org": "string",
"channel": "official",
"visibility": "private",
"version": "string",
"displayName": "string",
"state": "submitted",
"stateReason": "string",
"submittedBy": "string",
"submittedAt": "2026-11-01T00:00:00Z",
"errorCount": 0,
"warningCount": 0,
"executableCount": 0,
"description": "string",
"readme": "string",
"changelog": "string",
"files": [
{
"path": "string",
"size": 0,
"sha256": "string",
"executable": false
}
],
"findings": [
{
"rule": "string",
"level": "malware",
"path": "string",
"message": "string"
}
],
"sha256": "string",
"size": 0,
"canReview": false,
"canManage": false
}Call with curl
curl "https://tara.phillipcli.cloud/v1/versions/<id>" \
-H "Authorization: Bearer $TARA_TOKEN"/v1/versions/{id}/fileContent of a file in the package
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | yes | |
path | query | string | yes |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | File content (text); binary or oversized files only have binary=true | application/json · object |
| 401 | Not signed in | application/problem+json · object |
| 404 | Not found | application/problem+json · object |
Example response
{
"path": "string",
"binary": false,
"content": "string"
}Call with curl
curl "https://tara.phillipcli.cloud/v1/versions/<id>/file?path=string" \
-H "Authorization: Bearer $TARA_TOKEN"/v1/versions/{id}/documents/{seq}Content of a document attached to a version (same view permission as the version details)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | yes | |
seq | path | integer | yes |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | Document (media type follows the format, for example text/markdown, application/pdf) | application/octet-stream · string (binary) |
| 401 | Not signed in | application/problem+json · object |
| 404 | Not found | application/problem+json · object |
Call with curl
curl "https://tara.phillipcli.cloud/v1/versions/<id>/documents/<seq>" \
-H "Authorization: Bearer $TARA_TOKEN"/v1/document-policyPolicy for attached documents (type, format, required by resource type)
Responses
| Code | Description | Type |
|---|---|---|
| 200 | Policy | application/json · object |
| 401 | Not signed in | application/problem+json · object |
Example response
{
"types": [
{
"code": "string",
"name": "string"
}
],
"formats": [
{
"ext": "string",
"mediaType": "string",
"maxBytes": 0
}
],
"required": {},
"recommended": {}
}Call with curl
curl "https://tara.phillipcli.cloud/v1/document-policy" \
-H "Authorization: Bearer $TARA_TOKEN"