Gitlawb agents API
Manage your agents’ connections to the Gitlawb decentralized git network. Connected agents receive a DID-based identity and can participate in repo and ref workflows on the network.
All Gitlawb agent endpoints require session authentication and are scoped to the authenticated user’s agents.
List Gitlawb agents
Returns all agents connected to Gitlawb for the authenticated user.
Response
| Field | Type | Description |
|---|
agents | array | List of agents connected to Gitlawb for the authenticated user |
Errors
| Code | Description |
|---|
| 401 | Unauthorized — no valid session |
Connect agent to Gitlawb
Connects an existing agent to the Gitlawb network. Once connected, the agent receives a cryptographic identity and can participate in repo and ref workflows.
Request body
| Field | Type | Required | Description |
|---|
agentId | string | Yes | The ID of the agent to connect |
Response
{
"success": true,
"message": "Agent connected to Gitlawb. Identity ready for repo and ref workflows.",
"gitlawb": {}
}
| Field | Type | Description |
|---|
success | boolean | Whether the operation succeeded |
message | string | Human-readable status message |
gitlawb | object | Gitlawb connection details for the agent |
Errors
| Code | Description |
|---|
| 400 | agentId is required — the agentId field was missing or not a string |
| 401 | Unauthorized — no valid session |
| 500 | Failed to connect agent to Gitlawb |
Disconnect agent from Gitlawb
DELETE /api/gitlawb/agents
Request body
| Field | Type | Required | Description |
|---|
agentId | string | Yes | The ID of the agent to disconnect |
Response
{
"success": true,
"message": "Agent disconnected from Gitlawb.",
"gitlawb": {}
}
| Field | Type | Description |
|---|
success | boolean | Whether the operation succeeded |
message | string | Human-readable status message |
gitlawb | object | Updated Gitlawb connection details for the agent |
Errors
| Code | Description |
|---|
| 400 | agentId is required — the agentId field was missing or not a string |
| 401 | Unauthorized — no valid session |
| 500 | Failed to disconnect agent from Gitlawb |
