Skip to main content
Returns a JWT-authenticated remote URL targeting the +import push namespace. Pushing to this URL triggers immediate cold-storage archival after pack distribution—useful for bulk ingestion where you don’t need the repository to stay on hot disk. 
// Default: read/write access, 1-year TTL
const importUrl = await repo.getImportRemoteURL();
// Returns: https://t:JWT@your-name.code.storage/repo-id+import.git

// Short-lived URL for a single push
const ciImportUrl = await repo.getImportRemoteURL({
  permissions: ['git:read', 'git:write'],
  ttl: 3600,
});

// Disable force push on every branch
const safeImportUrl = await repo.getImportRemoteURL({
  refPolicies: [{ pattern: "refs/heads/*", ops: ["no-force-push"] }],
});

​
Options

​
permissions
string[]
Array of permissions. Defaults to ["git:read", "git:write"].
​
ttl
number
Token TTL in seconds. Defaults to 1 year.
​
refPolicies
object[]
Ordered per-ref policy rules ({ pattern, ops? }). First match wins. Patterns without a refs/ prefix are normalized as branch names. The Python SDK names this option ref_policies. The Go SDK names it RefPolicies with type storage.RefPolicyList. See getRemoteURL() for available operations and the Branch Protection guide for usage.

​
Response

Returns a string containing the HTTPS Git remote URL with embedded JWT authentication: 
https://t:{jwt}@{org}.code.storage/{repo-id}+import.git

​
Usage

Use the URL as a standard Git remote. Pushing to it enqueues cold-storage archival immediately after the pack distributes to all nodes: 
git remote add import <url>
git push import main
git push import --tags
See the Imports guide for bulk ingestion workflows and cold-storage behavior.