Save a sound
save_sound, in Changes: A connection or key that may make changes. None spends credits; prepare_* and stage tools (research, brainstorm, write_script, review, generate_clip, voice, storyboard) prepare paid work for confirm_spend.
Save a sound into a Space's library, as the member: a trending sound by its soundId from list_trending_sounds, or a video of the Space's library's own sound by its assetId. It answers the saved sound (saved, its asset and version, which prepare_video attaches In video as the video's music), a save under way (saving: ask again with a new requestKey to see it saved, which costs nothing), or why it couldn't be saved (failed, a daily saving limit among the reasons). Saving is free to the member. Pass a new requestKey; repeating one answers as before and saves nothing more.
apiKeyAuthorizationBearer <token>An API key (prb_…) from Settings → Connections.
application/json- body
spaceId*stringuuidsoundId?string^\d{1,32}$assetId?stringuuidrequestKey*string^[\w.:-]+$8 <= length <= 64The tool's answer.
application/json- response
status*stringsaveId*string^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidassetId*string^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidversionId*string^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidcurl -X POST 'https://probably.co/api/v1/tools/save_sound' \ -H "Authorization: Bearer $PROBABLY_API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "spaceId": "a330a273-e64a-4183-aedb-f3152797a9a5", "requestKey": "stringst"}'{ "status": "saved", "saveId": "74ed121c-77fc-4732-94b5-bf70f9ed328c", "assetId": "9179b887-04ef-4ce5-ab3a-b5bbd39ea3c8", "versionId": "14707576-2549-4848-82ed-f68f8a1b47c7"}