EnterpriseAPI Reference
Run the Gitar agent
Run the Gitar agent. The agent will analyze the repository and perform automated tasks. Requires Administrator scope.
AuthorizationBearer <token>
In: header
branch_name?string | null
Optional branch name for the execution. If not provided, a default branch will be created.
instructionsstring
Instructions for the agent to execute
metadata?ExternalMetadata | null
repositoryRepositoryReference
Platform-specific repository reference
GitHub repository
dataGithubRepository
GitHub repository
platformstring
Value in
"github"GitLab repository
dataGitlabRepository
GitLab repository
platformstring
Value in
"gitlab"run_id?string | null
Optional run ID to continue a previous conversation. When provided, the agent maintains context from the previous run, allowing for follow-up instructions and iterative work.
Response Body
curl -X POST "https://api.gitar.ai/v1/external/runs" \ -H "Content-Type: application/json" \ -d '{ "instructions": "string", "repository": { "data": { "owner": "string", "repo": "string" }, "platform": "github" } }'{
"branch_name": "string",
"created_at": "string",
"repository": {
"data": {
"owner": "string",
"repo": "string"
},
"platform": "github"
},
"run_id": "string",
"status": "string",
"updated_at": "string"
}Empty
Empty
Empty
Empty
{
"message": "string"
}