# Create link — POST /v1/git/link URL: https://docs.hanzo.ai/docs/openapi/git/post-git-link > Links every repository of the caller's org that holds no history here and names no link to github.com//, where GitHub lets the caller read it. `POST /v1/git/link` > [Git →](https://docs.hanzo.ai/docs/openapi/git) · [All API references →](https://docs.hanzo.ai/docs/openapi) · [Get started →](https://docs.hanzo.ai/docs/guides) | | | | ------------- | -------------------------------------- | | **Address** | `https://api.hanzo.ai/v1/git/link` | | **Method** | `POST` | | **Operation** | `post_git_link` | | **Auth** | `Authorization: Bearer $HANZO_API_KEY` | Links every repository of the caller's org that holds no history here and names no link to github.com/\/\, where GitHub lets the caller read it. A repository with no such namesake is listed and left alone, and one holding history here is listed and never touched. Nothing is fetched: a linked repository's cache fills on its first read. Org admins only. ## Request 1 field, body `application/json` (required). | Field | In | Type | Required | Description | | ------- | ---- | ------ | -------- | -------------------------------------------------------------------------------------------------- | | `owner` | body | string | — | Owner is the GitHub account a repository named n is looked for under, as github.com/\/\. | ## Response | Status | Body | Meaning | | --------- | --------------- | ------- | | `200` | git.linked | ok | | `default` | problem-details | refused | `200` body — 24 fields. | Field | In | Type | Always | Description | | ------------------------ | ---- | ---------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | `held` | body | string\[] | — | Held are the repositories that hold their own history here, which a link would hide. | | `linked` | body | git.repoView\[] | — | Linked are the repositories it linked, each to its namesake on GitHub. | | `linked[].branches` | body | string\[] | — | Branches are the repo's branch names. | | `linked[].cloneUrl` | body | string | — | CloneURL is the HTTPS smart-HTTP remote `git clone` takes. | | `linked[].createdAt` | body | string | — | CreatedAt is RFC 3339 UTC. | | `linked[].defaultBranch` | body | string | — | DefaultBranch is where HEAD points on a fresh repo ("main"). | | `linked[].description` | body | string | — | Description is the caller-supplied blurb (max 4KiB). | | `linked[].head` | body | string | — | Head is the resolved HEAD commit, empty on an empty repo. | | `linked[].id` | body | string | — | ID is the repo's stable, prefixed identifier ("repo\_" + 128 random bits). | | `linked[].link` | body | git.link | — | | | `linked[].link.cloneUrl` | body | string | — | CloneURL is the address its history is fetched from and pushed to. | | `linked[].link.name` | body | string | — | Name is the repository's name on its provider. | | `linked[].link.owner` | body | string | — | Owner is the account the repository belongs to on its provider. | | `linked[].link.provider` | body | string | — | Provider is "github", "forge" (git.hanzo.ai, Hanzo's own), or "git" for any other host. | | `linked[].name` | body | string | — | Name is the org-unique handle, and the last path segment of both URLs below. | | `linked[].org` | body | string | — | Org owns the repo — the gateway-minted X-Org-Id, and the isolation key. | | `linked[].project` | body | string | — | Project is the optional sub-scope the repo lives in; absent for the org's default scope. | | `linked[].public` | body | boolean | — | Public grants ANONYMOUS read (fetch) only; push and the whole control plane stay org-authed. | | `linked[].sizeBytes` | body | integer (int64) | — | SizeBytes is the repo's measured on-disk size, re-measured on create, after each push, and after a gc. | | `linked[].sshUrl` | body | string | — | SSHURL is the scp-style SSH remote (git\@host:org/repo.git). | | `linked[].updatedAt` | body | string | — | UpdatedAt is RFC 3339 UTC, empty until the first write. | | `unmatched` | body | git.unmatched\[] | — | Unmatched are the repositories it left as they were, each with what GitHub answered: no namesake readable as the caller is never replaced by a guess. | | `unmatched[].name` | body | string | — | Name is the repository. | | `unmatched[].reason` | body | string | — | Reason is what GitHub answered about its namesake. | Failure carries the platform error shape — see [Errors](https://docs.hanzo.ai/docs/errors). ## Examples **CLI** ```bash hanzo git link ``` **SDK** **.ts** ```ts import { Configuration, GitApi } from 'hanzoai'; const api = new GitApi(new Configuration({ accessToken: process.env.HANZO_API_KEY })); const { data } = await api.postGitLink({ owner: "" }); ``` **.py** ```python from hanzoai.cloud import ApiClient, Configuration from hanzoai.cloud.api import GitApi client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"])) result = GitApi(client).post_git_link(owner="") ``` **.go** ```go cfg := hanzoai.NewConfiguration() cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY")) client := hanzoai.NewAPIClient(cfg) resp, _, err := client.GitAPI.PostGitLink(context.Background()).Execute() if err != nil { return err } ``` **.rs** ```rust use hanzo_client::apis::{configuration::Configuration, git_api}; let mut cfg = Configuration::new(); cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok(); let result = git_api::post_git_link(&cfg, Default::default()).await?; ``` **.java** ```java import ai.hanzo.cloud.ApiClient; import ai.hanzo.cloud.api.GitApi; ApiClient client = new ApiClient(); client.setBearerToken(System.getenv("HANZO_API_KEY")); var result = new GitApi(client).postGitLink(); ``` **HTTP** ```bash curl -X POST https://api.hanzo.ai/v1/git/link \ -H "Authorization: Bearer $HANZO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "owner": "" }' ``` **MCP** MCP reaches **git** through the `git` tool, which names its 41 operations with its own verbs — this one among them, under a name only MCP declares. `describe` explains any of them: ```bash curl -X POST https://api.hanzo.ai/v1/mcp \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "describe", "arguments": { "op": "get_git_activity" } } }' ``` --- [Git API](https://docs.hanzo.ai/docs/openapi/git) · [All Hanzo APIs](https://docs.hanzo.ai/docs/openapi) · [Interactive reference](https://docs.hanzo.ai/docs/openapi/reference)