Content

Get content

Get file content or directory listing at a path. Use Accept: application/json for the JSON union response, or Accept: application/octet-stream for raw file bytes. Directory + octet-stream requests return 406 Not Acceptable.

File, symlink, and directory responses include an optional metadata field with the path’s metadata when any is set; the field is omitted otherwise. Values are plain UTF-8 strings. Directory listings additionally surface per-entry metadata inline on each row in entries[] (also UTF-8 strings, omitted when empty). Reads at a historical change_id return today’s metadata for the resolved path, not the values as of that change (metadata is stored separately from Git history).

Directory listings can be filtered by metadata predicates: ?metadata[key]=value, repeatable. Multiple keys are AND-ed (exact-value match). Entries without metadata (or with mismatched values) are dropped from entries[]. The filter is ignored when the resolved path is a file or symlink.

GET

{org}

{repo}

content

Get content

curl --request GET \
  --url https://api.mesa.dev/v1/{org}/{repo}/content \
  --header 'Authorization: Bearer <token>'

{
  "type": "<string>",
  "name": "<string>",
  "path": "<string>",
  "sha": "<string>",
  "size": 123,
  "encoding": "<string>",
  "content": "<string>",
  "is_conflicted": true,
  "metadata": {}
}

Required scope: read

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

org

string

required

Organization slug

Minimum string length: 1

repo

string

required

Repository name

Minimum string length: 1

Query Parameters

change_id

string

Change id to read content from. Defaults to the current change at the default bookmark tip. You may also pass the virtual root change id (zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz) to read the empty tree.

Pattern: ^[zyxwvutsrqponmlk]{32}$

path

string

depth

integer

Directory traversal depth: 0 for directory metadata only, 1 for direct children, up to 10

Required range: 0 <= x <= 10

metadata

object

Filter directory entries[] to rows whose metadata matches. Pass one param per key as a deepObject: ?metadata[<key>]=<value>, repeatable. Multiple keys are AND-ed (an entry must match every pair to survive; exact-value match). Ignored when the resolved path is a file or symlink. Example: ?metadata[tag]=archived&metadata[lang]=en.

Show child attributes

Response

Content response

Option 1
Option 2
Option 3

type

string

required

Allowed value: "file"

name

string

required

path

string

required

sha

string

required

size

number

required

encoding

string

required

Allowed value: "base64"

content

string

required

mode

enum<string>

required

POSIX file mode for a regular file

Available options:

100644,

100755

is_conflicted

boolean

metadata

object

Metadata attached to this path. Values are UTF-8 strings. Always reflects current values; not snapshotted with change_id.

Show child attributes

Bulk update tags

List bookmarks