Skip to content

API Tara: importing ​

Import resources (plugins, skills, agents, commands) from GitHub repositories

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.

POST/v1/imports/github/scan

Find 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) ​

FieldTypeRequiredDescription
sourcestringyesGitHub or GitLab repository URL, or GitHub owner/repo[@ref][/path]. A GitLab URL is https://host/group[/sub]/project[/-/tree/<ref>/<path>]

Responses ​

CodeDescriptionType
200What was found, at a pinned commitapplication/json · object
400Invalid inputapplication/problem+json · object
401Not signed inapplication/problem+json · object
403Not allowed: private repository outside its organization (private_repo), cannot publish to the target, read-only tokenapplication/problem+json · object
404Repository or ref not found (repo_not_found, ref_not_found)application/problem+json · object
502GitHub did not answer or its rate limit was reachedapplication/problem+json · object

Example response ​

json
{
  "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 ​

bash
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"}'
POST/v1/imports/github

Import 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) ​

FieldTypeRequiredDescription
sourcestringyes
shastringCommit SHA from the scan (empty imports the current ref)
itemsstring[]yesIds from the scan
targetstringyespersonal (your own store) or the slug of an organization you may publish to

Responses ​

CodeDescriptionType
200One result per item (an item can fail while others succeed)application/json · object
400Invalid inputapplication/problem+json · object
401Not signed inapplication/problem+json · object
403Not allowed: private repository outside its organization (private_repo), cannot publish to the target, read-only tokenapplication/problem+json · object
404Repository or ref not found (repo_not_found, ref_not_found)application/problem+json · object
502GitHub did not answer or its rate limit was reachedapplication/problem+json · object

Example response ​

json
{
  "results": [
    {
      "id": "string",
      "name": "acme/skill-pdf",
      "kind": "skill",
      "version": "string",
      "outcome": "published"
    }
  ]
}

Call with curl ​

bash
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"}'
POST/v1/orgs/{org}/imports/github/scan

Find 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 ​

NameInTypeRequiredDescription
orgpathstringyesOrganization slug (the caller must be a member; otherwise 404). Private repositories are read through this organization's GitHub App installation.

Body (application/json) ​

FieldTypeRequiredDescription
sourcestringyesGitHub or GitLab repository URL, or GitHub owner/repo[@ref][/path]. A GitLab URL is https://host/group[/sub]/project[/-/tree/<ref>/<path>]

Responses ​

CodeDescriptionType
200What was found, at a pinned commitapplication/json · object
400Invalid inputapplication/problem+json · object
401Not signed inapplication/problem+json · object
403Not allowed: private repository outside its organization (private_repo), cannot publish to the target, read-only tokenapplication/problem+json · object
404Repository or ref not found (repo_not_found, ref_not_found)application/problem+json · object
502GitHub did not answer or its rate limit was reachedapplication/problem+json · object

Example response ​

json
{
  "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 ​

bash
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"}'
POST/v1/orgs/{org}/imports/github

Import 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 ​

NameInTypeRequiredDescription
orgpathstringyesOrganization slug (the caller must be a member; otherwise 404). Private repositories are read through this organization's GitHub App installation.

Body (application/json) ​

FieldTypeRequiredDescription
sourcestringyes
shastringCommit SHA from the scan (empty imports the current ref)
itemsstring[]yesIds from the scan
targetstringyespersonal (your own store) or the slug of an organization you may publish to

Responses ​

CodeDescriptionType
200One result per item (an item can fail while others succeed)application/json · object
400Invalid inputapplication/problem+json · object
401Not signed inapplication/problem+json · object
403Not allowed: private repository outside its organization (private_repo), cannot publish to the target, read-only tokenapplication/problem+json · object
404Repository or ref not found (repo_not_found, ref_not_found)application/problem+json · object
502GitHub did not answer or its rate limit was reachedapplication/problem+json · object

Example response ​

json
{
  "results": [
    {
      "id": "string",
      "name": "acme/skill-pdf",
      "kind": "skill",
      "version": "string",
      "outcome": "published"
    }
  ]
}

Call with curl ​

bash
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"}'
POST/v1/imports/scan

Find 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) ​

FieldTypeRequiredDescription
sourcestringyesGitHub or GitLab repository URL, or GitHub owner/repo[@ref][/path]. A GitLab URL is https://host/group[/sub]/project[/-/tree/<ref>/<path>]

Responses ​

CodeDescriptionType
200What was found, at a pinned commitapplication/json · object
400Invalid input (including a GitLab host this server does not allow, host_not_allowed)application/problem+json · object
401Not signed inapplication/problem+json · object
403Not allowed: private repository outside its organization (private_repo), cannot publish to the target, read-only tokenapplication/problem+json · object
404Repository or ref not found (repo_not_found, ref_not_found), or GitLab import is not available on this serverapplication/problem+json · object
502GitHub or GitLab did not answer or its rate limit was reachedapplication/problem+json · object

Example response ​

json
{
  "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 ​

bash
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"}'
POST/v1/imports

Import 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) ​

FieldTypeRequiredDescription
sourcestringyes
shastringCommit SHA from the scan (empty imports the current ref)
itemsstring[]yesIds from the scan
targetstringyespersonal (your own store) or the slug of an organization you may publish to

Responses ​

CodeDescriptionType
200One result per item (an item can fail while others succeed)application/json · object
400Invalid input (including a GitLab host this server does not allow, host_not_allowed)application/problem+json · object
401Not signed inapplication/problem+json · object
403Not allowed: private repository outside its organization (private_repo), cannot publish to the target, read-only tokenapplication/problem+json · object
404Repository or ref not found (repo_not_found, ref_not_found), or GitLab import is not available on this serverapplication/problem+json · object
502GitHub or GitLab did not answer or its rate limit was reachedapplication/problem+json · object

Example response ​

json
{
  "results": [
    {
      "id": "string",
      "name": "acme/skill-pdf",
      "kind": "skill",
      "version": "string",
      "outcome": "published"
    }
  ]
}

Call with curl ​

bash
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"}'
POST/v1/orgs/{org}/imports/scan

Find 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 ​

NameInTypeRequiredDescription
orgpathstringyesOrganization 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) ​

FieldTypeRequiredDescription
sourcestringyesGitHub or GitLab repository URL, or GitHub owner/repo[@ref][/path]. A GitLab URL is https://host/group[/sub]/project[/-/tree/<ref>/<path>]

Responses ​

CodeDescriptionType
200What was found, at a pinned commitapplication/json · object
400Invalid input (including a GitLab host this server does not allow, host_not_allowed)application/problem+json · object
401Not signed inapplication/problem+json · object
403Not allowed: private repository outside its organization (private_repo), cannot publish to the target, read-only tokenapplication/problem+json · object
404Repository or ref not found (repo_not_found, ref_not_found), or GitLab import is not available on this serverapplication/problem+json · object
502GitHub or GitLab did not answer or its rate limit was reachedapplication/problem+json · object

Example response ​

json
{
  "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 ​

bash
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"}'
POST/v1/orgs/{org}/imports

Import 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 ​

NameInTypeRequiredDescription
orgpathstringyesOrganization 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) ​

FieldTypeRequiredDescription
sourcestringyes
shastringCommit SHA from the scan (empty imports the current ref)
itemsstring[]yesIds from the scan
targetstringyespersonal (your own store) or the slug of an organization you may publish to

Responses ​

CodeDescriptionType
200One result per item (an item can fail while others succeed)application/json · object
400Invalid input (including a GitLab host this server does not allow, host_not_allowed)application/problem+json · object
401Not signed inapplication/problem+json · object
403Not allowed: private repository outside its organization (private_repo), cannot publish to the target, read-only tokenapplication/problem+json · object
404Repository or ref not found (repo_not_found, ref_not_found), or GitLab import is not available on this serverapplication/problem+json · object
502GitHub or GitLab did not answer or its rate limit was reachedapplication/problem+json · object

Example response ​

json
{
  "results": [
    {
      "id": "string",
      "name": "acme/skill-pdf",
      "kind": "skill",
      "version": "string",
      "outcome": "published"
    }
  ]
}

Call with curl ​

bash
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"}'