# Tool Repository {% hint style="danger" %} **Deprecated in v0.9.44**: All tool repository browsing endpoints have been removed. Tool source code is now managed exclusively through the [Agent Forge CLI](https://docs.amigo.ai/reference/agent-forge) and direct repository access. Tool publishing, versioning, and execution through the [Tools API](/developer-guide/classic-api/core-api/tools.md) are unaffected. {% endhint %} {% hint style="info" %} **Conceptual Docs**: For an overview of how actions and their source code fit into the platform, see the [Actions documentation](https://docs.amigo.ai/agent/actions). {% endhint %} The Tool Repository API previously provided read-only access to the version-controlled source code behind an organization's tools. These endpoints have been removed as of v0.9.44. Use the Agent Forge CLI for source code management. **Permission required:** `Tool:AccessRepo` for all endpoints below. ## Access Management Organization administrators control which users can browse the tool repository. Repository access is granted and revoked independently of tool execution permissions. ### Grant Repository Access Grant a user read access to the organization's tool repository. | | | | -------------- | ---------------------------------------------------- | | **Method** | `POST` | | **Path** | `/v1/{organization}/user/{user_id}/tool-repo-access` | | **Permission** | `User:UpdateUserInfo` | | **Response** | `200 OK` | ### Revoke Repository Access Remove a user's read access to the tool repository. | | | | -------------- | ---------------------------------------------------- | | **Method** | `DELETE` | | **Path** | `/v1/{organization}/user/{user_id}/tool-repo-access` | | **Permission** | `User:UpdateUserInfo` | | **Response** | `204 No Content` | ## Branches ### List Branches List all branches in the tool repository with pagination. | | | | -------------- | ------------------------------------- | | **Method** | `GET` | | **Path** | `/v1/{organization}/tool/repo/branch` | | **Rate Limit** | 60 requests/min | **Query Parameters** | Parameter | Type | Default | Description | | -------------------- | ------- | ------- | ------------------------------- | | `limit` | integer | 20 | Max branches to return (max 20) | | `continuation_token` | integer | 1 | Pagination token | **Response** | Field | Type | Description | | ----------------------------- | --------------- | ------------------------------------ | | `branches` | array | List of branch objects | | `branches[].name` | string | Branch name | | `branches[].commit_sha` | string | Latest commit SHA | | `branches[].commit_message` | string | Latest commit message | | `branches[].commit_timestamp` | datetime | Latest commit timestamp | | `branches[].committer` | object or null | `{org_id, user_id}` of the committer | | `continuation_token` | integer or null | Token for the next page | | `has_more` | boolean | Whether more branches exist | ### Get Branch Get details for a single branch. | | | | -------------- | --------------------------------------------------- | | **Method** | `GET` | | **Path** | `/v1/{organization}/tool/repo/branch/{branch_name}` | | **Rate Limit** | 60 requests/min | **Response** | Field | Type | Description | | ------------------ | -------------- | ------------------------------------ | | `commit_sha` | string | Latest commit SHA | | `commit_message` | string | Latest commit message | | `commit_timestamp` | datetime | Latest commit timestamp | | `committer` | object or null | `{org_id, user_id}` of the committer | ## Commits ### List Commits Browse commit history with optional filtering by branch, file path, and date range. | | | | -------------- | ------------------------------------- | | **Method** | `GET` | | **Path** | `/v1/{organization}/tool/repo/commit` | | **Rate Limit** | 60 requests/min | **Query Parameters** | Parameter | Type | Default | Description | | ------------------------ | -------- | -------- | --------------------------------------------- | | `ref` | string | `"main"` | Branch name or commit SHA | | `path` | string | - | Filter commits that touch this file path | | `committed_on_or_after` | datetime | - | Only commits after this timestamp (UTC) | | `committed_on_or_before` | datetime | - | Only commits before this timestamp (UTC) | | `show_changed_files` | boolean | false | Include list of changed file paths per commit | | `show_change_stats` | boolean | false | Include addition/deletion counts per commit | | `limit` | integer | 20 | Max commits to return (max 20) | | `continuation_token` | integer | 1 | Pagination token | **Response** | Field | Type | Description | | ---------------------------- | --------------- | ---------------------------------------------------------------- | | `commits` | array | List of commit objects | | `commits[].commit_sha` | string | Commit SHA | | `commits[].commit_message` | string | Commit message | | `commits[].commit_timestamp` | datetime | Commit timestamp | | `commits[].committer` | object or null | `{org_id, user_id}` of the committer | | `commits[].changed_files` | object | Map of `{path: "added"\|"modified"\|"deleted"}` (when requested) | | `commits[].change_stats` | object or null | `{additions, deletions}` counts (when requested) | | `next_continuation_token` | integer or null | Token for the next page | | `has_more` | boolean | Whether more commits exist | ### Get Commit Diff Get the raw diff for a specific commit. | | | | -------------- | ------------------------------------------------ | | **Method** | `GET` | | **Path** | `/v1/{organization}/tool/repo/commit/{sha}/diff` | | **Rate Limit** | 60 requests/min | **Response**: Raw diff text (string). ## Files and Directories ### List Directory List the contents of a directory in the repository. | | | | -------------- | --------------------------------------------------------- | | **Method** | `GET` | | **Path** | `/v1/{organization}/tool/repo/directory/{directory_path}` | | **Rate Limit** | 60 requests/min | **Query Parameters** | Parameter | Type | Default | Description | | -------------------------- | ------- | -------- | --------------------------------------- | | `ref` | string | `"main"` | Branch name or commit SHA | | `include_last_commit_info` | boolean | false | Include last commit info for each entry | **Response** | Field | Type | Description | | -------------------------------------- | -------------- | ----------------------------------------------------------------- | | `directory_entries` | array | List of directory entry objects | | `directory_entries[].type` | string | `"file"` or `"directory"` | | `directory_entries[].name` | string | Entry name | | `directory_entries[].size` | integer | Size in bytes | | `directory_entries[].last_commit_info` | object or null | `{commit_sha, commit_message, commit_timestamp}` (when requested) | ### Get Files (Batch) Retrieve metadata and base64-encoded content for up to 5 files in a single request. | | | | -------------- | ----------------------------------- | | **Method** | `POST` | | **Path** | `/v1/{organization}/tool/repo/file` | | **Rate Limit** | 60 requests/min | {% hint style="warning" %} **Breaking Change**: This endpoint was changed from `GET` to `POST` with a JSON request body. The `ref` and `file_paths` parameters are now sent in the JSON body instead of as query/form parameters. {% endhint %} **Request Body (JSON)** | Parameter | Type | Default | Description | | ------------ | ---------------- | -------- | -------------------------- | | `ref` | string | `"main"` | Branch name or commit SHA | | `file_paths` | array of strings | - | 1-5 file paths to retrieve | **Response** | Field | Type | Description | | --------------------------------- | -------------- | ------------------------------------------------ | | `file_entries` | array | List of file entry objects | | `file_entries[].path` | string | File path | | `file_entries[].size` | integer | Size in bytes | | `file_entries[].content` | string or null | Base64-encoded file content | | `file_entries[].last_commit_info` | object | `{commit_sha, commit_message, commit_timestamp}` | ### Get File Content Download the raw content of a single file. | | | | -------------- | ----------------------------------------------- | | **Method** | `GET` | | **Path** | `/v1/{organization}/tool/repo/file/{file_path}` | | **Rate Limit** | 50 requests/min | **Query Parameters** | Parameter | Type | Default | Description | | --------- | ------ | -------- | ------------------------- | | `ref` | string | `"main"` | Branch name or commit SHA | **Response**: Raw binary file content (streaming). ## Related * Classic API → [Tools](/developer-guide/classic-api/core-api/tools.md) * Classic API → [Users](/developer-guide/classic-api/core-api/users.md) * Getting Started → [Authentication](/developer-guide/getting-started/authentication.md) * Permissions → [Role-Based Permissions](/developer-guide/classic-api/permissions/role-based-permissions.md) --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.amigo.ai/developer-guide/classic-api/core-api/tool-repository.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.