HeyMarvin API
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
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, etc.).
#
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
/bucket/developer-uploads/{developeruploadid}/a1b2c3d4-.../media.mp4
POST /bucket/developer-uploads/{developerUploadId}/a1b2c3d4-.../media.mp4
#
Specifications
Schemas & Data
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