API Tara: importing
Import resources (plugins, skills, agents, commands) from GitHub repositories
This page is generated from
openapi.yamlbynpm run gen, so do not edit it by hand. Authentication is described on the overview page.
/v1/imports/github/scanFind importable Claude Code resources in a GitHub repository (nothing is saved)
Paste https://github.com/owner/repo, .../tree/<ref>/<path> or owner/repo[@ref][/path]. Tara resolves the ref to a commit SHA, downloads that commit's archive (50 MiB compressed, 200 MiB unpacked, 10 MiB per file, no symlinks, no paths outside the repo) and lists what it finds: plugins (.claude-plugin/plugin.json, or local marketplace.json entries), skills (folders with SKILL.md), agents (.claude/agents/*.md), commands (.claude/commands/*.md, imported as skills) and .mcp.json files. Public repositories only, except that a private repository of this organization's GitHub App installation can be scanned by a member who can publish to the organization (and imported only into that organization). Each item carries the detected license and whether the license policy lets it into a personal store or into an organization.
Body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
source | string | yes | GitHub or GitLab repository URL, or GitHub owner/repo[@ref][/path]. A GitLab URL is https://host/group[/sub]/project[/-/tree/<ref>/<path>] |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | What was found, at a pinned commit | application/json · object |
| 400 | Invalid input | application/problem+json · object |
| 401 | Not signed in | application/problem+json · object |
| 403 | Not allowed: private repository outside its organization (private_repo), cannot publish to the target, read-only token | application/problem+json · object |
| 404 | Repository or ref not found (repo_not_found, ref_not_found) | application/problem+json · object |
| 502 | GitHub did not answer or its rate limit was reached | application/problem+json · object |
Example response
{
"provider": "github",
"host": "https://gitlab.com",
"repo": "owner/repo",
"ref": "string",
"sha": "string",
"private": false,
"skipped": [
"string"
],
"items": [
{
"id": "skill:skills/pdf",
"form": "plugin",
"kind": "skill",
"name": "skill-pdf",
"title": "string",
"description": "string",
"path": "string",
"files": 0,
"license": {},
"allowedPersonal": false,
"allowedOrg": false,
"notes": []
}
]
}Call with curl
curl -X POST "https://tara.phillipcli.cloud/v1/imports/github/scan" \
-H "Authorization: Bearer $TARA_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source":"https://github.com/owner/repo"}'/v1/imports/githubImport the chosen resources from a GitHub repository
Imports the items chosen from a scan, at the scanned commit sha, as normal packages: they go through Submit and the full automatic scanner, and are released immediately when it passes (there is no human review for personal and organization stores; the official aiforge/ catalog is not an import target). Names are <owner>/<kind>-<name> with owner = target (your handle, or an organization slug you may publish to). Provenance (repository, ref, commit, path, license) is recorded in metadata.forge.source and shown in the Portal. Importing again from the same source creates a new version only when the content changed (unchanged otherwise). License policy: permissive and copyleft licenses are accepted; restrictive or unrecognized ones are blocked; a repository with no license can only go to your personal store; your own repositories need no license. Results are per item.
Body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
source | string | yes | |
sha | string | Commit SHA from the scan (empty imports the current ref) | |
items | string[] | yes | Ids from the scan |
target | string | yes | personal (your own store) or the slug of an organization you may publish to |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | One result per item (an item can fail while others succeed) | application/json · object |
| 400 | Invalid input | application/problem+json · object |
| 401 | Not signed in | application/problem+json · object |
| 403 | Not allowed: private repository outside its organization (private_repo), cannot publish to the target, read-only token | application/problem+json · object |
| 404 | Repository or ref not found (repo_not_found, ref_not_found) | application/problem+json · object |
| 502 | GitHub did not answer or its rate limit was reached | application/problem+json · object |
Example response
{
"results": [
{
"id": "string",
"name": "acme/skill-pdf",
"kind": "skill",
"version": "string",
"outcome": "published"
}
]
}Call with curl
curl -X POST "https://tara.phillipcli.cloud/v1/imports/github" \
-H "Authorization: Bearer $TARA_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source":"string","sha":"string","items":["string"],"target":"personal"}'/v1/orgs/{org}/imports/github/scanFind importable Claude Code resources in a GitHub repository (nothing is saved)
Paste https://github.com/owner/repo, .../tree/<ref>/<path> or owner/repo[@ref][/path]. Tara resolves the ref to a commit SHA, downloads that commit's archive (50 MiB compressed, 200 MiB unpacked, 10 MiB per file, no symlinks, no paths outside the repo) and lists what it finds: plugins (.claude-plugin/plugin.json, or local marketplace.json entries), skills (folders with SKILL.md), agents (.claude/agents/*.md), commands (.claude/commands/*.md, imported as skills) and .mcp.json files. Public repositories only, except that a private repository of this organization's GitHub App installation can be scanned by a member who can publish to the organization (and imported only into that organization). Each item carries the detected license and whether the license policy lets it into a personal store or into an organization.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
org | path | string | yes | Organization slug (the caller must be a member; otherwise 404). Private repositories are read through this organization's GitHub App installation. |
Body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
source | string | yes | GitHub or GitLab repository URL, or GitHub owner/repo[@ref][/path]. A GitLab URL is https://host/group[/sub]/project[/-/tree/<ref>/<path>] |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | What was found, at a pinned commit | application/json · object |
| 400 | Invalid input | application/problem+json · object |
| 401 | Not signed in | application/problem+json · object |
| 403 | Not allowed: private repository outside its organization (private_repo), cannot publish to the target, read-only token | application/problem+json · object |
| 404 | Repository or ref not found (repo_not_found, ref_not_found) | application/problem+json · object |
| 502 | GitHub did not answer or its rate limit was reached | application/problem+json · object |
Example response
{
"provider": "github",
"host": "https://gitlab.com",
"repo": "owner/repo",
"ref": "string",
"sha": "string",
"private": false,
"skipped": [
"string"
],
"items": [
{
"id": "skill:skills/pdf",
"form": "plugin",
"kind": "skill",
"name": "skill-pdf",
"title": "string",
"description": "string",
"path": "string",
"files": 0,
"license": {},
"allowedPersonal": false,
"allowedOrg": false,
"notes": []
}
]
}Call with curl
curl -X POST "https://tara.phillipcli.cloud/v1/orgs/<org>/imports/github/scan" \
-H "Authorization: Bearer $TARA_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source":"https://github.com/owner/repo"}'/v1/orgs/{org}/imports/githubImport the chosen resources from a GitHub repository
Imports the items chosen from a scan, at the scanned commit sha, as normal packages: they go through Submit and the full automatic scanner, and are released immediately when it passes (there is no human review for personal and organization stores; the official aiforge/ catalog is not an import target). Names are <owner>/<kind>-<name> with owner = target (your handle, or an organization slug you may publish to). Provenance (repository, ref, commit, path, license) is recorded in metadata.forge.source and shown in the Portal. Importing again from the same source creates a new version only when the content changed (unchanged otherwise). License policy: permissive and copyleft licenses are accepted; restrictive or unrecognized ones are blocked; a repository with no license can only go to your personal store; your own repositories need no license. Results are per item.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
org | path | string | yes | Organization slug (the caller must be a member; otherwise 404). Private repositories are read through this organization's GitHub App installation. |
Body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
source | string | yes | |
sha | string | Commit SHA from the scan (empty imports the current ref) | |
items | string[] | yes | Ids from the scan |
target | string | yes | personal (your own store) or the slug of an organization you may publish to |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | One result per item (an item can fail while others succeed) | application/json · object |
| 400 | Invalid input | application/problem+json · object |
| 401 | Not signed in | application/problem+json · object |
| 403 | Not allowed: private repository outside its organization (private_repo), cannot publish to the target, read-only token | application/problem+json · object |
| 404 | Repository or ref not found (repo_not_found, ref_not_found) | application/problem+json · object |
| 502 | GitHub did not answer or its rate limit was reached | application/problem+json · object |
Example response
{
"results": [
{
"id": "string",
"name": "acme/skill-pdf",
"kind": "skill",
"version": "string",
"outcome": "published"
}
]
}Call with curl
curl -X POST "https://tara.phillipcli.cloud/v1/orgs/<org>/imports/github" \
-H "Authorization: Bearer $TARA_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source":"string","sha":"string","items":["string"],"target":"personal"}'/v1/imports/scanFind importable Claude Code resources in a GitHub or GitLab repository (nothing is saved)
Paste a GitHub URL (https://github.com/owner/repo, .../tree/<ref>/<path>, owner/repo[@ref][/path]) or a GitLab URL (https://gitlab.com/group/sub/project, .../-/tree/<ref>/<path>, .../-/blob/<ref>/<file>, git@host:group/project.git); the provider is detected from the host. GitLab hosts must be allowed on this server (gitlab.com and the hosts in TARA_GITLAB_PROVIDERS, the same list as the organization GitLab connection), and Tara never follows a redirect to another host. Tara resolves the ref to a commit SHA, downloads that commit's archive (50 MiB compressed, 200 MiB unpacked, 10 MiB per file, no symlinks, no paths outside the repo) and lists what it finds: plugins, skills, agents, commands and .mcp.json files. Public repositories are read anonymously; a private repository can only be scanned by a member who can publish to the organization when it is in the organization's GitHub App installation, or inside the group of its GitLab connection (and it can be imported only into that organization). Each item carries the detected license and whether the license policy lets it into a personal store or into an organization.
Body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
source | string | yes | GitHub or GitLab repository URL, or GitHub owner/repo[@ref][/path]. A GitLab URL is https://host/group[/sub]/project[/-/tree/<ref>/<path>] |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | What was found, at a pinned commit | application/json · object |
| 400 | Invalid input (including a GitLab host this server does not allow, host_not_allowed) | application/problem+json · object |
| 401 | Not signed in | application/problem+json · object |
| 403 | Not allowed: private repository outside its organization (private_repo), cannot publish to the target, read-only token | application/problem+json · object |
| 404 | Repository or ref not found (repo_not_found, ref_not_found), or GitLab import is not available on this server | application/problem+json · object |
| 502 | GitHub or GitLab did not answer or its rate limit was reached | application/problem+json · object |
Example response
{
"provider": "github",
"host": "https://gitlab.com",
"repo": "owner/repo",
"ref": "string",
"sha": "string",
"private": false,
"skipped": [
"string"
],
"items": [
{
"id": "skill:skills/pdf",
"form": "plugin",
"kind": "skill",
"name": "skill-pdf",
"title": "string",
"description": "string",
"path": "string",
"files": 0,
"license": {},
"allowedPersonal": false,
"allowedOrg": false,
"notes": []
}
]
}Call with curl
curl -X POST "https://tara.phillipcli.cloud/v1/imports/scan" \
-H "Authorization: Bearer $TARA_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source":"https://github.com/owner/repo"}'/v1/importsImport the chosen resources from a GitHub or GitLab repository
Imports the items chosen from a scan (GitHub or GitLab), at the scanned commit sha, as normal packages: they go through Submit and the full automatic scanner, and are released immediately when it passes (no human review for personal and organization stores; the official aiforge/ catalog is not an import target). Names are <owner>/<kind>-<name> with owner = target. Provenance (provider, host, repository, ref, commit, path, license) is recorded in metadata.forge.source. Importing again creates a new version only when the content changed (unchanged otherwise). License policy: permissive and copyleft licenses are accepted; restrictive or unrecognized ones are blocked; a repository with no license can only go to your personal store; a repository of the organization's own GitHub App installation or GitLab group needs no license. Results are per item.
Body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
source | string | yes | |
sha | string | Commit SHA from the scan (empty imports the current ref) | |
items | string[] | yes | Ids from the scan |
target | string | yes | personal (your own store) or the slug of an organization you may publish to |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | One result per item (an item can fail while others succeed) | application/json · object |
| 400 | Invalid input (including a GitLab host this server does not allow, host_not_allowed) | application/problem+json · object |
| 401 | Not signed in | application/problem+json · object |
| 403 | Not allowed: private repository outside its organization (private_repo), cannot publish to the target, read-only token | application/problem+json · object |
| 404 | Repository or ref not found (repo_not_found, ref_not_found), or GitLab import is not available on this server | application/problem+json · object |
| 502 | GitHub or GitLab did not answer or its rate limit was reached | application/problem+json · object |
Example response
{
"results": [
{
"id": "string",
"name": "acme/skill-pdf",
"kind": "skill",
"version": "string",
"outcome": "published"
}
]
}Call with curl
curl -X POST "https://tara.phillipcli.cloud/v1/imports" \
-H "Authorization: Bearer $TARA_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source":"string","sha":"string","items":["string"],"target":"personal"}'/v1/orgs/{org}/imports/scanFind importable Claude Code resources in a GitHub or GitLab repository (nothing is saved)
Paste a GitHub URL (https://github.com/owner/repo, .../tree/<ref>/<path>, owner/repo[@ref][/path]) or a GitLab URL (https://gitlab.com/group/sub/project, .../-/tree/<ref>/<path>, .../-/blob/<ref>/<file>, git@host:group/project.git); the provider is detected from the host. GitLab hosts must be allowed on this server (gitlab.com and the hosts in TARA_GITLAB_PROVIDERS, the same list as the organization GitLab connection), and Tara never follows a redirect to another host. Tara resolves the ref to a commit SHA, downloads that commit's archive (50 MiB compressed, 200 MiB unpacked, 10 MiB per file, no symlinks, no paths outside the repo) and lists what it finds: plugins, skills, agents, commands and .mcp.json files. Public repositories are read anonymously; a private repository can only be scanned by a member who can publish to the organization when it is in the organization's GitHub App installation, or inside the group of its GitLab connection (and it can be imported only into that organization). Each item carries the detected license and whether the license policy lets it into a personal store or into an organization.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
org | path | string | yes | Organization slug (the caller must be a member; otherwise 404). Private repositories are read through this organization's GitHub App installation or GitLab connection. |
Body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
source | string | yes | GitHub or GitLab repository URL, or GitHub owner/repo[@ref][/path]. A GitLab URL is https://host/group[/sub]/project[/-/tree/<ref>/<path>] |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | What was found, at a pinned commit | application/json · object |
| 400 | Invalid input (including a GitLab host this server does not allow, host_not_allowed) | application/problem+json · object |
| 401 | Not signed in | application/problem+json · object |
| 403 | Not allowed: private repository outside its organization (private_repo), cannot publish to the target, read-only token | application/problem+json · object |
| 404 | Repository or ref not found (repo_not_found, ref_not_found), or GitLab import is not available on this server | application/problem+json · object |
| 502 | GitHub or GitLab did not answer or its rate limit was reached | application/problem+json · object |
Example response
{
"provider": "github",
"host": "https://gitlab.com",
"repo": "owner/repo",
"ref": "string",
"sha": "string",
"private": false,
"skipped": [
"string"
],
"items": [
{
"id": "skill:skills/pdf",
"form": "plugin",
"kind": "skill",
"name": "skill-pdf",
"title": "string",
"description": "string",
"path": "string",
"files": 0,
"license": {},
"allowedPersonal": false,
"allowedOrg": false,
"notes": []
}
]
}Call with curl
curl -X POST "https://tara.phillipcli.cloud/v1/orgs/<org>/imports/scan" \
-H "Authorization: Bearer $TARA_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source":"https://github.com/owner/repo"}'/v1/orgs/{org}/importsImport the chosen resources from a GitHub or GitLab repository
Imports the items chosen from a scan (GitHub or GitLab), at the scanned commit sha, as normal packages: they go through Submit and the full automatic scanner, and are released immediately when it passes (no human review for personal and organization stores; the official aiforge/ catalog is not an import target). Names are <owner>/<kind>-<name> with owner = target. Provenance (provider, host, repository, ref, commit, path, license) is recorded in metadata.forge.source. Importing again creates a new version only when the content changed (unchanged otherwise). License policy: permissive and copyleft licenses are accepted; restrictive or unrecognized ones are blocked; a repository with no license can only go to your personal store; a repository of the organization's own GitHub App installation or GitLab group needs no license. Results are per item.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
org | path | string | yes | Organization slug (the caller must be a member; otherwise 404). Private repositories are read through this organization's GitHub App installation or GitLab connection. |
Body (application/json)
| Field | Type | Required | Description |
|---|---|---|---|
source | string | yes | |
sha | string | Commit SHA from the scan (empty imports the current ref) | |
items | string[] | yes | Ids from the scan |
target | string | yes | personal (your own store) or the slug of an organization you may publish to |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | One result per item (an item can fail while others succeed) | application/json · object |
| 400 | Invalid input (including a GitLab host this server does not allow, host_not_allowed) | application/problem+json · object |
| 401 | Not signed in | application/problem+json · object |
| 403 | Not allowed: private repository outside its organization (private_repo), cannot publish to the target, read-only token | application/problem+json · object |
| 404 | Repository or ref not found (repo_not_found, ref_not_found), or GitLab import is not available on this server | application/problem+json · object |
| 502 | GitHub or GitLab did not answer or its rate limit was reached | application/problem+json · object |
Example response
{
"results": [
{
"id": "string",
"name": "acme/skill-pdf",
"kind": "skill",
"version": "string",
"outcome": "published"
}
]
}Call with curl
curl -X POST "https://tara.phillipcli.cloud/v1/orgs/<org>/imports" \
-H "Authorization: Bearer $TARA_TOKEN" \
-H "Content-Type: application/json" \
-d '{"source":"string","sha":"string","items":["string"],"target":"personal"}'