GET /repositories/home — Get Home Repository

Retrieve the authenticated user’s Home repository — the default workspace where pipelines and datasets land when no specific repository is named.

Use this endpoint to resolve your account’s Home repository. The Home repository is the default destination when creating pipelines or datasets without specifying a repositoryId. The response has the same shape as GET /repositories/{id}.

Workspace-aware alternative — GET /repositories/default. If your account belongs to multiple teams/workspaces, prefer GET /repositories/default. It returns the default writable repository for the API key’s currently active workspace, whereas /repositories/home always resolves the single per-user Home repo. The Alphacast MCP server uses /repositories/default when it auto-resolves a repository. Both endpoints return the same repository object shape.

Request

GET https://api.alphacast.io/repositories/home

Authentication

This endpoint requires HTTP Basic Auth. Pass your API key as the username and leave the password empty.

Response

Returns a single repository object — the same structure as GET /repositories/{id}.

id · integer

Unique numeric identifier for the Home repository.

name · string

Display name of the repository.

description · string

Optional description of the repository’s contents or purpose.

privacy · string

Visibility setting. Either "Public" or "Private".

team · string

The team this repository belongs to, if applicable.

permission · string

Your access level. For your Home repository this is always "Owner".

Example

cURL

curl -u YOUR_API_KEY: \
  https://api.alphacast.io/repositories/home

import requests

response = requests.get(
    "https://api.alphacast.io/repositories/home",
    auth=("YOUR_API_KEY", ""),
)
home = response.json()
print(home["id"])  # use this ID when creating datasets or pipelines

const response = await fetch("https://api.alphacast.io/repositories/home", {
  headers: { Authorization: "Basic " + btoa("YOUR_API_KEY:") },
});
const home = await response.json();

200

{
  "id": 42,
  "name": "Home",
  "description": null,
  "privacy": "Private",
  "team": null,
  "permission": "Owner"
}

Store the Home repository ID if you plan to create multiple datasets or pipelines — it saves a round-trip on each creation request.