Sources API
API endpoints for managing tool sources in the Kubiya platform
Sources API
Sources in Kubiya are collections of tools that can be attached to teammates. Sources can be Git repositories, directories, or other tool collections. The Sources API allows you to create, discover, synchronize, and manage sources.
This playground makes API calls to Kubiya API through a secure server-side proxy. Your requests never expose your API token directly to the browser.
Endpoints
Method | Path | Description |
---|---|---|
GET | /api/v1/sources | List all sources |
GET | /api/v1/sources/{sourceId} | Get source by ID |
GET | /api/v1/sources/{sourceId}/metadata | Get source metadata |
GET | /api/v1/sources/load | Discover/load a source (GET) |
POST | /api/v1/sources | Create a new source |
PUT | /api/v1/sources/{sourceId} | Sync a source |
DELETE | /api/v1/sources/{sourceId} | Delete a source |
GET | /api/v1/sources/agent_sources/{sourceId} | Get agent sources |
PUT | /api/v1/sources/zip/load | Load a zipped source |
PUT | /api/v1/sources/zip | Create a zipped source |
PUT | /api/v1/sources/zip/sync/{sourceId} | Sync a zipped source |
List All Sources
Headers
Name | Required | Description |
---|---|---|
Authorization | Yes | UserKey YOUR_API_KEY |
Response
Get Source by ID
Path Parameters
Name | Type | Required | Description |
---|---|---|---|
sourceId | string | Yes | ID of the source to retrieve |
Headers
Name | Required | Description |
---|---|---|
Authorization | Yes | UserKey YOUR_API_KEY |
Response
Get Source Metadata
Response
Discover/Load a Source
Response
Create a Source
Headers
Name | Required | Description |
---|---|---|
Authorization | Yes | UserKey YOUR_API_KEY |
Content-Type | Yes | application/json |
Request Body
Response
Sync a Source
Request Body
Response
Delete a Source
Response
A successful delete operation returns HTTP 200 with no body.
Get Agent Sources
Response
Zip Endpoints
Load a Zipped Source
Create a Zipped Source
Sync a Zipped Source
Deprecated/Legacy Endpoints: The following endpoints were present in previous documentation but are not in the current Go implementation. They may be deprecated or handled elsewhere:
GET /v1/sources/{source_id}/tools