hermes-agent/pinchflat
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Format ci.yml and API.md with prettier
Build and Test / Build and Test (push) Successful in 8m8s
Details

Browse Source
This commit is contained in:
Hermes Agent
2026-07-04 10:12:11 +00:00
parent 517f3f0329
commit 8e0ec4b8b9
2 changed files with 39 additions and 39 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/API.md
+37 -37
View File
@@ -29,54 +29,54 @@ All endpoints are under `/api/v1`.
### Sources ### Sources
| Method | Path | Description | | Method | Path | Description |
|--------|------|-------------| | ------ | --------------------------------------------------- | ------------------------------------ |
| GET | `/api/v1/sources` | List all sources | | GET | `/api/v1/sources` | List all sources |
| GET | `/api/v1/sources/:id` | Get a source with its pending tasks | | GET | `/api/v1/sources/:id` | Get a source with its pending tasks |
| POST | `/api/v1/sources` | Create a new source | | POST | `/api/v1/sources` | Create a new source |
| PUT | `/api/v1/sources/:id` | Update a source | | PUT | `/api/v1/sources/:id` | Update a source |
| DELETE | `/api/v1/sources/:id` | Delete a source (marks for deletion) | | DELETE | `/api/v1/sources/:id` | Delete a source (marks for deletion) |
| POST | `/api/v1/sources/:source_id/force_download_pending` | Force download pending media | | POST | `/api/v1/sources/:source_id/force_download_pending` | Force download pending media |
| POST | `/api/v1/sources/:source_id/force_redownload` | Force re-download existing media | | POST | `/api/v1/sources/:source_id/force_redownload` | Force re-download existing media |
| POST | `/api/v1/sources/:source_id/force_index` | Force re-index | | POST | `/api/v1/sources/:source_id/force_index` | Force re-index |
| POST | `/api/v1/sources/:source_id/force_metadata_refresh` | Force metadata refresh | | POST | `/api/v1/sources/:source_id/force_metadata_refresh` | Force metadata refresh |
| POST | `/api/v1/sources/:source_id/sync_files_on_disk` | Sync files on disk | | POST | `/api/v1/sources/:source_id/sync_files_on_disk` | Sync files on disk |
### Media Items ### Media Items
| Method | Path | Description | | Method | Path | Description |
|--------|------|-------------| | ------ | --------------------------------------------- | ----------------------------------------------------- |
| GET | `/api/v1/media` | List all media items (optional `?source_id=X` filter) | | GET | `/api/v1/media` | List all media items (optional `?source_id=X` filter) |
| GET | `/api/v1/media/search?q=query` | Search media items | | GET | `/api/v1/media/search?q=query` | Search media items |
| GET | `/api/v1/media/:id` | Get a media item | | GET | `/api/v1/media/:id` | Get a media item |
| PUT | `/api/v1/media/:id` | Update a media item | | PUT | `/api/v1/media/:id` | Update a media item |
| DELETE | `/api/v1/media/:id` | Delete media files | | DELETE | `/api/v1/media/:id` | Delete media files |
| POST | `/api/v1/media/:media_item_id/force_download` | Force download a media item | | POST | `/api/v1/media/:media_item_id/force_download` | Force download a media item |
### Media Profiles ### Media Profiles
| Method | Path | Description | | Method | Path | Description |
|--------|------|-------------| | ------ | ---------------------------- | ----------------------- |
| GET | `/api/v1/media_profiles` | List all media profiles | | GET | `/api/v1/media_profiles` | List all media profiles |
| GET | `/api/v1/media_profiles/:id` | Get a media profile | | GET | `/api/v1/media_profiles/:id` | Get a media profile |
| POST | `/api/v1/media_profiles` | Create a media profile | | POST | `/api/v1/media_profiles` | Create a media profile |
| PUT | `/api/v1/media_profiles/:id` | Update a media profile | | PUT | `/api/v1/media_profiles/:id` | Update a media profile |
| DELETE | `/api/v1/media_profiles/:id` | Delete a media profile | | DELETE | `/api/v1/media_profiles/:id` | Delete a media profile |
### Settings ### Settings
| Method | Path | Description | | Method | Path | Description |
|--------|------|-------------| | ------ | ------------------ | ----------------------------------------- |
| GET | `/api/v1/settings` | Get settings (route_token excluded) | | GET | `/api/v1/settings` | Get settings (route_token excluded) |
| PUT | `/api/v1/settings` | Update settings | | PUT | `/api/v1/settings` | Update settings |
| GET | `/api/v1/app_info` | Get app info (version, environment, etc.) | | GET | `/api/v1/app_info` | Get app info (version, environment, etc.) |
### Tasks ### Tasks
| Method | Path | Description | | Method | Path | Description |
|--------|------|-------------| | ------ | ------------------- | ----------------------------------------------- |
| GET | `/api/v1/tasks` | List all tasks (optional `?source_id=X` filter) | | GET | `/api/v1/tasks` | List all tasks (optional `?source_id=X` filter) |
| GET | `/api/v1/tasks/:id` | Get a task | | GET | `/api/v1/tasks/:id` | Get a task |
## Response Format ## Response Format
@@ -89,7 +89,7 @@ All responses are JSON. Successful responses use:
Error responses use: Error responses use:
```json ```json
{"errors": {"field": "error message"}} { "errors": { "field": "error message" } }
``` ```
## Example: Create a Source ## Example: Create a Source