PUT /repositories/{id} — Update a Repository

curl -u YOUR_API_KEY: \
  -X PUT \
  -H "Content-Type: application/json" \
  -d '{
    "name": "EM Macro — Archived",
    "description": "Historical GDP, inflation, and rates for EM economies",
    "privacy": "Public"
  }' \
  https://api.alphacast.io/repositories/101

import requests

response = requests.put(
    "https://api.alphacast.io/repositories/101",
    auth=("YOUR_API_KEY", ""),
    json={
        "name": "EM Macro — Archived",
        "description": "Historical GDP, inflation, and rates for EM economies",
        "privacy": "Public",
    },
)
repository = response.json()

const response = await fetch("https://api.alphacast.io/repositories/101", {
  method: "PUT",
  headers: {
    Authorization: "Basic " + btoa("YOUR_API_KEY:"),
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "EM Macro — Archived",
    description: "Historical GDP, inflation, and rates for EM economies",
    privacy: "Public",
  }),
});
const repository = await response.json();

{
  "id": 101,
  "name": "EM Macro — Archived",
  "description": "Historical GDP, inflation, and rates for EM economies",
  "privacy": "Public",
  "team": "research",
  "permission": "Owner"
}

Use this endpoint to rename a repository, update its description, or change its visibility between public and private. Only the repository owner can make these changes — users with Admin, Write, Clone, or Read access will receive a 403 error.

Request

PUT https://api.alphacast.io/repositories/{repository_id}

Send a JSON body with the Content-Type: application/json header.

Authentication

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

You must have Owner permission on the repository to update it. Requests from users with any other permission level will be rejected with a 403 Forbidden response.

Path parameters

integer

required

The numeric ID of the repository to update.

Body parameters

string

required

New display name for the repository.

string

required

Visibility setting. Must be either "Public" or "Private".

string

Updated description of the repository’s contents or purpose.

Response

Returns 200 with the updated repository object.

integer

Unique numeric identifier for the repository.

string

Updated display name of the repository.

string

Updated description, if provided.

string

Updated visibility setting. Either "Public" or "Private".

string

The team this repository belongs to. Team association cannot be changed via this endpoint.

string

Your access level. Remains "Owner" after an update.

Errors

Status	Meaning
`403`	You do not have `Owner` permission on this repository.
`404`	No repository with the given ID exists, or you do not have access to it.

Example

curl -u YOUR_API_KEY: \
  -X PUT \
  -H "Content-Type: application/json" \
  -d '{
    "name": "EM Macro — Archived",
    "description": "Historical GDP, inflation, and rates for EM economies",
    "privacy": "Public"
  }' \
  https://api.alphacast.io/repositories/101

import requests

response = requests.put(
    "https://api.alphacast.io/repositories/101",
    auth=("YOUR_API_KEY", ""),
    json={
        "name": "EM Macro — Archived",
        "description": "Historical GDP, inflation, and rates for EM economies",
        "privacy": "Public",
    },
)
repository = response.json()

const response = await fetch("https://api.alphacast.io/repositories/101", {
  method: "PUT",
  headers: {
    Authorization: "Basic " + btoa("YOUR_API_KEY:"),
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "EM Macro — Archived",
    description: "Historical GDP, inflation, and rates for EM economies",
    privacy: "Public",
  }),
});
const repository = await response.json();

{
  "id": 101,
  "name": "EM Macro — Archived",
  "description": "Historical GDP, inflation, and rates for EM economies",
  "privacy": "Public",
  "team": "research",
  "permission": "Owner"
}

curl -u YOUR_API_KEY: \
  -X PUT \
  -H "Content-Type: application/json" \
  -d '{
    "name": "EM Macro — Archived",
    "description": "Historical GDP, inflation, and rates for EM economies",
    "privacy": "Public"
  }' \
  https://api.alphacast.io/repositories/101

import requests

response = requests.put(
    "https://api.alphacast.io/repositories/101",
    auth=("YOUR_API_KEY", ""),
    json={
        "name": "EM Macro — Archived",
        "description": "Historical GDP, inflation, and rates for EM economies",
        "privacy": "Public",
    },
)
repository = response.json()

const response = await fetch("https://api.alphacast.io/repositories/101", {
  method: "PUT",
  headers: {
    Authorization: "Basic " + btoa("YOUR_API_KEY:"),
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "EM Macro — Archived",
    description: "Historical GDP, inflation, and rates for EM economies",
    privacy: "Public",
  }),
});
const repository = await response.json();

{
  "id": 101,
  "name": "EM Macro — Archived",
  "description": "Historical GDP, inflation, and rates for EM economies",
  "privacy": "Public",
  "team": "research",
  "permission": "Owner"
}

Overview

Repositories

Datasets

Data Providers

PUT /repositories/{id} — Update a Repository

Request

Authentication

Path parameters

Body parameters

Response

Errors

Example