Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mesa.dev/llms.txt

Use this file to discover all available pages before exploring further.

Update mutable repository fields. 
const repo = await mesa.repos.update({
  repo: 'app',
  default_bookmark: 'main',
  tags: { env: 'prod', stale: null },
});

​
Options

​
repo
string
required
Current repository name.
​
org
string | undefined
Organization override.
​
name
string | undefined
New repository name.
​
default_bookmark
string | undefined
New default bookmark name.
​
tags
Record<string, string | null> | undefined
Patch repository tags. String values set tags, null removes tags, and omitted keys are unchanged.
​
upstream
object | null | undefined
Set, replace, or remove the upstream remote. Omit to preserve the current upstream, pass null to remove it, or pass an object to attach/update it.

​
Upstream auth updates

On update, upstream credentials are tri-state: omit upstream to preserve the whole upstream, pass upstream: null to remove it, pass upstream.auth: null to clear credentials, or pass token / username-password auth to replace credentials.

​
Response

Returns the updated repository object.

​
Required scope

write