> ## Documentation Index
> Fetch the complete documentation index at: https://alphacastio.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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}`.

<Note>
  **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.
</Note>

## Request

```bash theme={null}
GET https://api.alphacast.io/repositories/home
```

## Authentication

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

## Response

Returns a single repository object — the same structure as [`GET /repositories/{id}`](/api/repositories/get).

<ResponseField name="id" type="integer">
  Unique numeric identifier for the Home repository.
</ResponseField>

<ResponseField name="name" type="string">
  Display name of the repository.
</ResponseField>

<ResponseField name="description" type="string">
  Optional description of the repository's contents or purpose.
</ResponseField>

<ResponseField name="privacy" type="string">
  Visibility setting. Either `"Public"` or `"Private"`.
</ResponseField>

<ResponseField name="team" type="string">
  The team this repository belongs to, if applicable.
</ResponseField>

<ResponseField name="permission" type="string">
  Your access level. For your Home repository this is always `"Owner"`.
</ResponseField>

## Example

<RequestExample>
  ```bash cURL theme={null}
  curl -u YOUR_API_KEY: \
    https://api.alphacast.io/repositories/home
  ```

  ```python Python theme={null}
  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
  ```

  ```javascript Node.js theme={null}
  const response = await fetch("https://api.alphacast.io/repositories/home", {
    headers: { Authorization: "Basic " + btoa("YOUR_API_KEY:") },
  });
  const home = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": 42,
    "name": "Home",
    "description": null,
    "privacy": "Private",
    "team": null,
    "permission": "Owner"
  }
  ```
</ResponseExample>

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