# Songtradr User API

**Canonical:** https://apis.io/apis/songtradr/songtradr-user-api/  
**Provider:** Songtradr — https://apis.io/providers/songtradr/  
**Base URL:** https://api.songtradr.com  
**Documentation:** https://api.songtradr.com/swagger-ui.html

Songtradr User API is one of 3 APIs that [Songtradr](https://apis.io/providers/songtradr/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include User. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and authentication docs.

The user API from Songtradr — 15 operation(s) for user.

## Operations (17)

| Method | Path | Summary |
|---|---|---|
| POST | `/api/v1/user/update-password` | Update password by using the password reset token |
| POST | `/api/v1/user/token` | Generates a new JWT token for the given refresh token |
| POST | `/api/v1/user/sign-up` | Sign up a new user. |
| GET | `/api/v1/user/me` | Details for a logged-in user |
| POST | `/api/v1/user/me` | Edit details for a logged-in user |
| POST | `/api/v1/user/login` | Login to generate a bearer token. |
| POST | `/api/v1/user/forgot-password` | Send a password reset email |
| POST | `/api/v1/user/file/{name}/initUpload` | Initialize a file upload. Responds with an URL where the file can be uploaded. |
| GET | `/api/v1/user/recording/{ids}` | Recordings by IDs with a medium sized response. |
| GET | `/api/v1/user/recording/{ids}/tagstrengths` | Strengths as numerical representations for AI generated moods, musical features and more for recordings. |
| GET | `/api/v1/user/recording/{ids}/taggrams` | Timeseries of AI generated moods, musical features and more for a list of recordings. |
| GET | `/api/v1/user/folder/{folderName}/tagstrengths` | Strengths as numerical representations for AI generated moods, musical features and more for recordings in your folder. |
| GET | `/api/v1/user/files` | List and search your own files. |
| GET | `/api/v1/user/filesSummary` | Summary fo your files. |
| GET | `/api/v1/user/filesStatus` | Status details for files. |
| GET | `/api/v1/user/file/{objectKey}` | Details and a download link for a file. |
| DELETE | `/api/v1/user/file/{objectKey}` | Delete file. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/songtradr/refs/heads/main/openapi/songtradr-user-api-openapi.yml
- **Documentation** — https://api.songtradr.com/swagger-ui.html
- **APIReference** — https://api.songtradr.com/v3/api-docs
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/songtradr/refs/heads/main/authentication/songtradr-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/songtradr/refs/heads/main/conventions/songtradr-conventions.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/songtradr/refs/heads/main/errors/songtradr-problem-types.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/songtradr/refs/heads/main/data-model/songtradr-data-model.yml

## Other Songtradr APIs (2)

- [Songtradr Allowed Values API](https://apis.io/apis/songtradr/songtradr-allowed-values-api/)
- [Songtradr Similarity Vector Controller API](https://apis.io/apis/songtradr/songtradr-similarity-vector-controller-api/)

## Tags

User

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/songtradr/songtradr-user-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/songtradr/.