# HeyMarvin API

**Canonical:** https://apis.io/apis/heymarvin/heymarvin-api/  
**Provider:** HeyMarvin — https://apis.io/providers/heymarvin/  
**Base URL:** https://app.heymarvin.com  
**Documentation:** https://docs.heymarvin.com/reference/files

HeyMarvin API is one of 2 APIs that [HeyMarvin](https://apis.io/providers/heymarvin/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

HeyMarvin API as documented publicly: 16 operations. Contract generated from the documentation by API Evangelist (2026-10-28); not the provider's own document.

## Operations (16)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/developer/import/files` | Lists files imported through this API, scoped to projects accessible to your API key, newest first. |
| POST | `/api/v1/developer/import/files/initialize` | Creates a wav record and returns a wav_key plus a presigned S3 upload URL. |
| POST | `/api/v1/developer/import/files/{wavKey}/complete` | Marvin checks that the object exists in S3, sets the file URL on the wav, and kicks off processing (transcription for audio/video, extraction for documents, ... |
| GET | `/api/v1/developer/import/files/{wavKey}/status` | Returns the current processing status for the uploaded file. |
| GET | `/api/v1/developer/import/surveys` | Lists surveys previously imported through this API that reached COMPLETED. |
| POST | `/api/v1/developer/import/surveys/initialize` | Creates a survey upload and returns presigned S3 URLs for each CSV part. |
| POST | `/api/v1/developer/import/surveys/{uploadKey}/append` | Add more rows to a survey previously imported through this API. |
| POST | `/api/v1/developer/import/surveys/{uploadKey}/complete` | Signals Marvin to verify uploads and start processing the survey. |
| POST | `/api/v1/developer/import/surveys/{uploadKey}/media/register` | After initialize, declare your media filenames to get a presigned S3 URL for each. |
| POST | `/api/v1/developer/import/surveys/{uploadKey}/media/{filename}/retry` | Re-issue a presigned URL for a single media file. |
| POST | `/api/v1/developer/import/surveys/{uploadKey}/parts/{partNumber}/retry` | Re-issues a fresh presigned URL for a CSV part. |
| GET | `/api/v1/developer/import/surveys/{uploadKey}/status` | Returns the current processing status for the survey upload. |
| POST | `/api/v1/oauth/token` | POST /api/v1/oauth/token |
| POST | `/bucket` | POST /bucket |
| POST | `/bucket/developer-uploads/{developeruploadid}/a1b2c3d4-.../media.mp4` | POST /bucket/developer-uploads/{developerUploadId}/a1b2c3d4-.../media.mp4 |
| GET | `/import/projects` | Resolves a project_id needed for file import operations. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/heymarvin/openapi/_ae-authored/heymarvin-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/heymarvin/json-schema/heymarvin-post-api-v1-developer-import-surveys-initialize-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/heymarvin/json-schema/heymarvin-post-bucket-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/heymarvin/json-schema/heymarvin-get-api-v1-developer-import-files-wavkey-status-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/heymarvin/json-schema/heymarvin-get-api-v1-developer-import-surveys-uploadkey-status-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/heymarvin/json-schema/heymarvin-get-api-v1-developer-import-files-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/heymarvin/json-schema/heymarvin-post-api-v1-developer-import-files-initialize-response-schema.json

## Other HeyMarvin APIs (1)

- [HeyMarvin API](https://apis.io/apis/heymarvin/heymarvin-api-2/)

---

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