Skip to Content
SeyloDocs
API referenceGit credentials

List a git repository's branches

GET
/api/v1/git.branches

Checks access to a git URL (with a stored credential for private repos, like git ls-remote) and lists its branches with the default one. Used to validate a generic git source before saving it.

Needs services.create on the project. Available to MCP clients and the assistant.

Authorization

cookieseylo_session<token>

Query Parameters

projectId*string

Panel-issued id.

Match^[a-z0-9]{16}$
url*string
Match^(https://|ssh://|git@)\S+$
Length1 <= length <= 500
credentialId?string

Panel-issued id.

Match^[a-z0-9]{16}$

Response Body

Success.

application/json
  1. response
branches*array<string>
defaultBranch*string|null
Example Request
curl -X GET 'https://example.com/api/v1/git.branches?projectId=string&url=string'
Example Response
{  "branches": [    "string"  ],  "defaultBranch": "string"}

Write a file POST

Creates or replaces a file with the given content (up to 1 MiB). Existing files keep their mode. Needs `files.write` on the service (a grant on its project covers it). Available to MCP clients and the assistant.

Add a git credential POST

Stores an HTTPS access token (kind token) or an SSH private key (kind ssh_key) for a git host, sealed. To have the panel make the key pair instead, use git.generateSshKey. Needs `git.manage`, which owners and admins hold. Not available to MCP clients or the assistant.