{"openapi":"3.0.0","info":{"title":"Waymark API v1","version":"1.0.0","description":"Waymark API v1","contact":{"name":"Waymark","email":"support@waymark.com","url":"https://waymark.com"},"license":{"name":"Proprietary","url":"https://waymark.com/legal/site-terms-of-use"}},"x-amazon-apigateway-request-validators":{"all":{"validateRequestBody":true,"validateRequestParameters":true},"body-only":{"validateRequestBody":true,"validateRequestParameters":false}},"x-amazon-apigateway-api-key-source":"HEADER","x-amazon-apigateway-gateway-responses":{"DEFAULT_4XX":{"responseParameters":{"gatewayresponse.header.Cache-Control":"'no-cache, no-store, must-revalidate'","gatewayresponse.header.Strict-Transport-Security":"'max-age=31536000; includeSubDomains'","gatewayresponse.header.X-Content-Type-Options":"'nosniff'"}},"DEFAULT_5XX":{"responseParameters":{"gatewayresponse.header.Cache-Control":"'no-cache, no-store, must-revalidate'","gatewayresponse.header.Strict-Transport-Security":"'max-age=31536000; includeSubDomains'","gatewayresponse.header.X-Content-Type-Options":"'nosniff'"}},"BAD_REQUEST_BODY":{"statusCode":400,"responseParameters":{"gatewayresponse.header.Cache-Control":"'no-cache, no-store, must-revalidate'","gatewayresponse.header.Strict-Transport-Security":"'max-age=31536000; includeSubDomains'","gatewayresponse.header.X-Content-Type-Options":"'nosniff'"},"responseTemplates":{"application/json":"{\n  \"code\": \"BAD_REQUEST\",\n  \"message\": \"\",\n  \"details\": {\n    \"validationErrors\": \n  }\n}\n"}},"BAD_REQUEST_PARAMETERS":{"statusCode":400,"responseParameters":{"gatewayresponse.header.Cache-Control":"'no-cache, no-store, must-revalidate'","gatewayresponse.header.Strict-Transport-Security":"'max-age=31536000; includeSubDomains'","gatewayresponse.header.X-Content-Type-Options":"'nosniff'"},"responseTemplates":{"application/json":"{\n  \"code\": \"BAD_REQUEST\",\n  \"message\": \"\",\n  \"details\": {\n    \"validationErrors\": \n  }\n}\n"}}},"tags":[{"name":"accounts","description":"Accounts operations"},{"name":"videos","description":"Video generation operations"},{"name":"editors","description":"Sharing and editor access for collaborative video editing"},{"name":"status","description":"General system status endpoints"}],"paths":{"/accounts/{accountGUID}":{"parameters":[{"name":"accountGUID","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"get":{"summary":"Get an account","tags":["accounts"],"security":[{"api-key":[]},{"authorization":["extapi/read","extapi/write","extapi/accounts.read","extapi/accounts.write"]}],"x-amazon-apigateway-request-validator":"all","responses":{"200":{"description":"Account details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Account"},"example":{"accountId":"00000000-0000-0000-0000-000000000001","email":"eldon@tyrellcorp.com","externalId":"1234567890","firstName":"Eldon","lastName":"Tyrell","status":"ACTIVE"}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalServerError"}},"x-amazon-apigateway-integration":{"type":"aws_proxy","httpMethod":"POST","uri":"arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-2:973273415135:function:wm-external-accounts-wm-prod-get/invocations","passthroughBehavior":"when_no_match"}}},"/accounts":{"get":{"summary":"Search accounts","tags":["accounts"],"security":[{"api-key":[]},{"authorization":["extapi/read","extapi/write","extapi/accounts.read","extapi/accounts.write"]}],"x-amazon-apigateway-request-validator":"all","parameters":[{"name":"email","in":"query","required":false,"schema":{"type":"string","format":"email"},"description":"Filter by email address"},{"name":"external_id","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by external ID"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":1000},"description":"Maximum number of results to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"minimum":0,"maximum":100000},"description":"Number of results to skip"}],"responses":{"200":{"description":"List of accounts matching the search criteria","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSearchResults"},"example":{"accounts":[{"accountGuid":"00000000-0000-0000-0000-000000000002","email":"jane@smith.com","externalId":"1234567891","firstName":"Jane","lastName":"Smith","status":"ACTIVE"},{"accountGuid":"00000000-0000-0000-0000-000000000003","email":"bob@wilson.com","externalId":"1234567892","firstName":"Bob","lastName":"Wilson","status":"INACTIVE"}],"total":2,"limit":20,"offset":0}}}},"400":{"$ref":"#/components/responses/BadRequest"},"500":{"$ref":"#/components/responses/InternalServerError"}},"x-amazon-apigateway-integration":{"type":"aws_proxy","httpMethod":"POST","uri":"arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-2:973273415135:function:wm-external-accounts-wm-prod-query/invocations","passthroughBehavior":"when_no_match"}},"post":{"summary":"Create an account","tags":["accounts"],"security":[{"api-key":[]},{"authorization":["extapi/write","extapi/accounts.write"]}],"x-amazon-apigateway-request-validator":"body-only","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountCreationRequest"},"examples":{"basic":{"summary":"Basic account creation request","value":{"email":"eldon@tyrellcorp.com","externalId":"1234567890","firstName":"Eldon","lastName":"Tyrell"}}}}},"required":true},"responses":{"201":{"description":"Account created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Account"},"example":{"accountId":"00000000-0000-0000-0000-000000000001","email":"eldon@tyrellcorp.com","externalId":"1234567890","firstName":"Eldon","lastName":"Tyrell","status":"ACTIVE"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/InternalServerError"}},"x-amazon-apigateway-integration":{"type":"aws_proxy","httpMethod":"POST","uri":"arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-2:973273415135:function:wm-external-accounts-wm-prod-post/invocations","passthroughBehavior":"when_no_match"}}},"/accounts/search":{"get":{"summary":"Prefix-search accounts in the partner org","description":"Case-insensitive prefix autocomplete across `email`, `firstName`, and\n`lastName` for accounts that belong to the requesting partner. A\nwhitespace-separated query (e.g. \"John Smith\") matches first name\nprefix AND last name prefix together. Results are capped at 50.\n","tags":["accounts"],"security":[{"api-key":[]},{"authorization":["extapi/read","extapi/write","extapi/accounts.read","extapi/accounts.write"]}],"x-amazon-apigateway-request-validator":"all","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":100},"description":"Prefix to match against email, first name, or last name."}],"responses":{"200":{"description":"Up to 50 accounts matching the prefix","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountSearchResults"},"example":{"accounts":[{"accountGuid":"00000000-0000-0000-0000-000000000002","email":"jane@smith.com","externalId":"1234567891","firstName":"Jane","lastName":"Smith","status":"ACTIVE"}],"total":1,"limit":50,"offset":0}}}},"400":{"$ref":"#/components/responses/BadRequest"},"500":{"$ref":"#/components/responses/InternalServerError"}},"x-amazon-apigateway-integration":{"type":"aws_proxy","httpMethod":"POST","uri":"arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-2:973273415135:function:wm-external-accounts-wm-prod-search/invocations","passthroughBehavior":"when_no_match"}}},"/time":{"get":{"summary":"Get the current time","tags":["status"],"security":[{"api-key":[]},{"authorization":["extapi/read","extapi/write","extapi/status.read"]}],"responses":{"200":{"description":"Successful time response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServerTime"},"example":{"time":"2011-11-11T11:11:11.000Z"}}}},"500":{"$ref":"#/components/responses/InternalServerError"}},"x-amazon-apigateway-integration":{"type":"aws_proxy","httpMethod":"POST","uri":"arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-2:973273415135:function:wm-external-time-wm-prod-ExternalTimeFunction31D8F-EnIwcWldP8L3/invocations","passthroughBehavior":"when_no_match"}}},"/videos":{"get":{"summary":"List videos","tags":["videos"],"security":[{"api-key":[]},{"authorization":["extapi/read","extapi/write","extapi/videos.read","extapi/videos.write"]}],"x-amazon-apigateway-request-validator":"all","parameters":[{"name":"accountGuid","in":"query","required":false,"schema":{"type":"string","format":"uuid"},"description":"Filter by account GUID"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"minimum":1,"maximum":1000},"description":"Maximum number of results to return"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"minimum":0,"maximum":100000},"description":"Number of results to skip"},{"name":"updatedAfter","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Filter videos updated after this timestamp (ISO 8601)"},{"name":"createdAfter","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Filter videos created after this timestamp (ISO 8601)"},{"name":"showDeleted","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Include deleted videos in results"},{"name":"videoIds","in":"query","required":false,"schema":{"type":"array","items":{"type":"string","format":"uuid"}},"description":"Filter by specific video GUIDs (repeat param for multiple)"}],"responses":{"200":{"description":"List of videos","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoSearchResults"},"example":{"videos":[{"videoId":"00000000-0000-0000-0000-000000000001","title":"My First Spot","isDeleted":false,"createdAt":"2026-03-12T12:00:00Z","updatedAt":"2026-03-12T12:00:00Z"},{"videoId":"00000000-0000-0000-0000-000000000002","title":"Summer Campaign","isDeleted":false,"createdAt":"2026-03-11T12:00:00Z","updatedAt":"2026-03-12T14:00:00Z"}],"total":2,"limit":100,"offset":0}}}},"400":{"$ref":"#/components/responses/BadRequest"},"500":{"$ref":"#/components/responses/InternalServerError"}},"x-amazon-apigateway-integration":{"type":"aws_proxy","httpMethod":"POST","uri":"arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-2:973273415135:function:wm-external-videos-wm-pro-ExternalVideosListFuncti-FwFiRNl2ZwdD/invocations","passthroughBehavior":"when_no_match"}}},"/videos/generate":{"post":{"summary":"Generate a video","tags":["videos"],"security":[{"api-key":[]},{"authorization":["extapi/write","extapi/videos.write"]}],"x-amazon-apigateway-request-validator":"body-only","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoGenerationRequest"},"examples":{"basic":{"summary":"Basic video generation request","value":{"accountGuid":"00000000-0000-0000-0000-000000000001","customerMetadata":"internal-campaign-id-456","topic":{"sourceUrl":"https://wanderlustcreamery.com"},"outputParameters":{"aspectRatio":"16:9","duration":30}}},"comprehensive":{"summary":"Full customization example","value":{"accountGuid":"00000000-0000-0000-0000-000000000001","customerMetadata":"internal-campaign-id-456","topic":{"sourceUrl":"https://wanderlustcreamery.com","data":{"name":"Wanderlust Creamery","address":{"streetAddress1":"123 Main St","city":"Los Angeles","state":"CA","postalCode":"90039","countryCode":"US"},"phone":"867-5309","websiteUrl":"https://wanderlustcreamery.com","description":"Artisanal ice cream inspired by travel","industry":"ice cream","images":["https://wanderlustcreamery.com/images/wanderlust-creamery-1.jpg","https://wanderlustcreamery.com/images/wanderlust-creamery-2.jpg","https://wanderlustcreamery.com/images/wanderlust-creamery-3.jpg"],"logoImageUrl":"https://wanderlustcreamery.com/images/wanderlust-creamery-logo.jpg"}},"outputParameters":{"aspectRatio":"16:9","duration":30},"customization":{"instructions":"Focus on our new flavor of the month","vibe":"Fun","languageCode":"en-US"},"webhookUrl":"https://webhook.site/my-id","title":"Summer Flavor Launch"}},"existing-topic":{"summary":"Existing topic","value":{"accountGuid":"00000000-0000-0000-0000-000000000001","customerMetadata":"internal-campaign-id-456","topicId":"00000000-0000-0000-0000-000000000002","outputParameters":{"aspectRatio":"4:5","duration":5},"webhookUrl":"https://webhook.site/my-id"}}}}},"required":true},"responses":{"202":{"description":"Video generation request accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoGenerationAccepted"},"example":{"requestId":"00000000-0000-0000-0000-000000000001","videoId":"00000000-0000-0000-0000-000000000002","topicId":"00000000-0000-0000-0000-000000000003","previewUrl":"https://video-preview.com/videos/00000000-0000-0000-0000-000000000002/preview","editUrl":"https://waymark.com/account/your-videos/00000000-0000-0000-0000-000000000002/edit"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"409":{"$ref":"#/components/responses/Conflict"},"500":{"$ref":"#/components/responses/InternalServerError"}},"x-amazon-apigateway-integration":{"type":"aws_proxy","httpMethod":"POST","uri":"arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-2:973273415135:function:wm-external-videos-wm-pro-ExternalVideosGenerateFu-dzxQhAAYRcAO/invocations","passthroughBehavior":"when_no_match"}}},"/videos/generation/{requestId}/status":{"parameters":[{"name":"requestId","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"Get the status of a video generation","tags":["videos"],"security":[{"api-key":[]},{"authorization":["extapi/read","extapi/write","extapi/videos.read","extapi/videos.write"]}],"x-amazon-apigateway-request-validator":"all","responses":{"200":{"description":"Video generation status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoGenerationStatus"},"example":{"requestId":"00000000-0000-0000-0000-000000000001","videoId":"00000000-0000-0000-0000-000000000002","status":"PROCESSING","customerMetadata":"internal-campaign-id-456"}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalServerError"}},"x-amazon-apigateway-integration":{"type":"aws_proxy","httpMethod":"POST","uri":"arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-2:973273415135:function:wm-external-videos-wm-pro-ExternalVideosStatusFunc-BrVSJocGU9OJ/invocations","passthroughBehavior":"when_no_match"}}},"/videos/{videoId}":{"parameters":[{"name":"videoId","in":"path","required":true,"schema":{"type":"string"}}],"get":{"summary":"Get the details of a video","tags":["videos"],"security":[{"api-key":[]},{"authorization":["extapi/read","extapi/write","extapi/videos.read","extapi/videos.write"]}],"x-amazon-apigateway-request-validator":"all","responses":{"200":{"description":"Video details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoDetails"},"example":{"videoId":"00000000-0000-0000-0000-000000000002","createdAt":"2025-01-08T12:00:00Z","updatedAt":"2025-01-08T12:00:00Z","previewUrl":"https://video-preview.com/videos/00000000-0000-0000-0000-000000000002/preview","editUrl":"https://waymark.com/account/your-videos/00000000-0000-0000-0000-000000000002/edit","aspectRatio":"16:9","duration":30,"variantSlug":"sample30_16x9"}}}},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalServerError"}},"x-amazon-apigateway-integration":{"type":"aws_proxy","httpMethod":"POST","uri":"arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-2:973273415135:function:wm-external-videos-wm-pro-ExternalVideosDetailsFun-7fUqNRGN1zfu/invocations","passthroughBehavior":"when_no_match"}},"delete":{"summary":"Delete a video","tags":["videos"],"security":[{"api-key":[]},{"authorization":["extapi/write","extapi/videos.write"]}],"x-amazon-apigateway-request-validator":"all","responses":{"204":{"description":"Video deleted"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalServerError"}},"x-amazon-apigateway-integration":{"type":"aws_proxy","httpMethod":"POST","uri":"arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-2:973273415135:function:wm-external-videos-wm-pro-ExternalVideosDeleteFunc-K34lQUewrU9L/invocations","passthroughBehavior":"when_no_match"}},"put":{"summary":"Update a video","tags":["videos"],"security":[{"api-key":[]},{"authorization":["extapi/write","extapi/videos.write"]}],"x-amazon-apigateway-request-validator":"body-only","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoUpdateRequest"},"examples":{"basic":{"summary":"Update video title","value":{"title":"My Updated Title"}}}}},"required":true},"responses":{"200":{"description":"Video updated","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoDetails"},"example":{"videoId":"00000000-0000-0000-0000-000000000002","title":"My Updated Title","createdAt":"2026-03-12T12:00:00Z","updatedAt":"2026-03-12T14:00:00Z","previewUrl":"https://video-preview.com/00000000-0000-0000-0000-000000000002","editUrl":"https://waymark.com/account/your-videos/00000000-0000-0000-0000-000000000002"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalServerError"}},"x-amazon-apigateway-integration":{"type":"aws_proxy","httpMethod":"POST","uri":"arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-2:973273415135:function:wm-external-videos-wm-pro-ExternalVideosUpdateFunc-9ELbROD6pgtB/invocations","passthroughBehavior":"when_no_match"}}},"/videos/{videoId}/editors":{"parameters":[{"name":"videoId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"post":{"summary":"Grant an account edit access to a video","description":"Grant edit access on `videoId` to `editorAccountGuid`. Use `isRevokable` to\ncontrol whether the video's owner can remove the grant themselves in the\nWaymark app; grants can always be managed through this API.\n","tags":["editors"],"security":[{"api-key":[]},{"authorization":["extapi/write","extapi/videos.write"]}],"x-amazon-apigateway-request-validator":"body-only","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoEditorGrantRequest"},"examples":{"basic":{"summary":"Standard grant","value":{"editorAccountGuid":"00000000-0000-0000-0000-000000000002"}},"nonRevokable":{"summary":"Grant the video's owner cannot remove","value":{"editorAccountGuid":"00000000-0000-0000-0000-000000000002","isRevokable":false}}}}},"required":true},"responses":{"200":{"description":"Existing grant returned (idempotent re-share)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoEditor"}}}},"201":{"description":"Editor grant created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoEditor"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalServerError"}},"x-amazon-apigateway-integration":{"type":"aws_proxy","httpMethod":"POST","uri":"arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-2:973273415135:function:wm-external-videos-wm-pro-ExternalVideosEditorGran-D1SRJN1rQYU8/invocations","passthroughBehavior":"when_no_match"}},"get":{"summary":"List the editors granted access to a video","tags":["editors"],"security":[{"api-key":[]},{"authorization":["extapi/read","extapi/write","extapi/videos.read","extapi/videos.write"]}],"x-amazon-apigateway-request-validator":"all","responses":{"200":{"description":"List of editor grants on the video","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoEditorListResponse"}}}},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalServerError"}},"x-amazon-apigateway-integration":{"type":"aws_proxy","httpMethod":"POST","uri":"arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-2:973273415135:function:wm-external-videos-wm-pro-ExternalVideosEditorList-oK98pLIfYKm0/invocations","passthroughBehavior":"when_no_match"}}},"/videos/{videoId}/editors/{accountId}":{"parameters":[{"name":"videoId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"accountId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"delete":{"summary":"Revoke an account's editor access on a video","description":"Remove an editor grant. Any grant can be removed through this endpoint,\nincluding those created with `isRevokable: false` — that flag only limits\nwhat the video's owner can do in the Waymark app. If the revoked account is\ncurrently editing the video, their editing session is ended.\n","tags":["editors"],"security":[{"api-key":[]},{"authorization":["extapi/write","extapi/videos.write"]}],"x-amazon-apigateway-request-validator":"all","responses":{"204":{"description":"Editor grant revoked"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/InternalServerError"}},"x-amazon-apigateway-integration":{"type":"aws_proxy","httpMethod":"POST","uri":"arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-2:973273415135:function:wm-external-videos-wm-pro-ExternalVideosEditorRevo-lqo4NQsfnvv8/invocations","passthroughBehavior":"when_no_match"}}},"/videos/transfer":{"post":{"summary":"Transfer video ownership between accounts","tags":["videos"],"security":[{"api-key":[]},{"authorization":["extapi/write","extapi/videos.write"]}],"x-amazon-apigateway-request-validator":"body-only","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoTransferRequest"},"examples":{"basic":{"summary":"Transfer a single video","value":{"sourceAccountGuid":"00000000-0000-0000-0000-000000000001","targetAccountGuid":"00000000-0000-0000-0000-000000000002","videoGuids":["00000000-0000-0000-0000-000000000003"]}},"multiple":{"summary":"Transfer multiple videos with metadata","value":{"sourceAccountGuid":"00000000-0000-0000-0000-000000000001","targetAccountGuid":"00000000-0000-0000-0000-000000000002","videoGuids":["00000000-0000-0000-0000-000000000003","00000000-0000-0000-0000-000000000004"],"customerMetadata":"salesforce-case-12345"}}}}},"required":true},"responses":{"200":{"description":"Video transfer completed (may include partial failures)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VideoTransferResponse"},"example":{"transferredCount":2,"transferredVideoGuids":["00000000-0000-0000-0000-000000000003","00000000-0000-0000-0000-000000000004"],"transferErrors":[]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"500":{"$ref":"#/components/responses/InternalServerError"}},"x-amazon-apigateway-integration":{"type":"aws_proxy","httpMethod":"POST","uri":"arn:aws:apigateway:us-east-2:lambda:path/2015-03-31/functions/arn:aws:lambda:us-east-2:973273415135:function:wm-external-videos-wm-pro-ExternalVideosTransferFu-zJlm9voX6Qak/invocations","passthroughBehavior":"when_no_match"}}}},"components":{"schemas":{"ApiError":{"type":"object","properties":{"code":{"type":"string","enum":["BAD_REQUEST","DUPLICATE_REQUEST","INTERNAL_SERVER_ERROR","NOT_FOUND","RATE_LIMITED","INVALID_ACCESS"]},"message":{"type":"string"},"details":{"type":"object"}},"required":["code","message"]},"AccountStatus":{"type":"string","enum":["ACTIVE","INACTIVE","PENDING_PASSWORD_SETUP"]},"Account":{"type":"object","properties":{"accountGuid":{"type":"string","format":"uuid"},"email":{"type":"string"},"externalId":{"type":"string"},"firstName":{"type":"string"},"lastName":{"type":"string"},"status":{"$ref":"#/components/schemas/AccountStatus"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["accountGuid","email","status","createdAt","updatedAt"]},"AccountCreationRequest":{"type":"object","properties":{"email":{"type":"string","format":"email"},"externalId":{"type":"string"},"firstName":{"type":"string"},"lastName":{"type":"string"},"companyName":{"type":"string"},"phone":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"accountGroups":{"type":"array","items":{"type":"string"}}}},"AccountSearchResults":{"type":"object","properties":{"accounts":{"type":"array","items":{"$ref":"#/components/schemas/Account"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}}},"VideoSummary":{"type":"object","properties":{"videoId":{"type":"string","format":"uuid"},"title":{"type":"string"},"isDeleted":{"type":"boolean"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}},"required":["videoId","title","isDeleted","createdAt","updatedAt"]},"VideoUpdateRequest":{"type":"object","properties":{"title":{"type":"string"}},"required":["title"]},"VideoSearchResults":{"type":"object","properties":{"videos":{"type":"array","items":{"$ref":"#/components/schemas/VideoSummary"}},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}},"required":["videos","total","limit","offset"]},"ServerTime":{"type":"object","properties":{"time":{"type":"string","format":"date-time","description":"The current time in RFC 3339 format"}},"required":["time"]},"TopicAddress":{"type":"object","properties":{"streetAddress1":{"type":"string"},"streetAddress2":{"type":"string"},"streetAddress3":{"type":"string"},"city":{"type":"string"},"state":{"type":"string"},"postalCode":{"type":"string"},"countryCode":{"type":"string"}}},"TopicData":{"type":"object","properties":{"name":{"type":"string"},"address":{"$ref":"#/components/schemas/TopicAddress"},"phone":{"type":"string"},"websiteUrl":{"type":"string"},"description":{"type":"string"},"industry":{"type":"string"},"images":{"type":"array","items":{"type":"string","format":"uri"}},"logoImageUrl":{"type":"string","format":"uri"}}},"Topic":{"type":"object","properties":{"sourceUrl":{"type":"string","format":"uri"},"data":{"$ref":"#/components/schemas/TopicData"}}},"AspectRatio":{"type":"string","enum":["16:9","4:5"]},"Duration":{"type":"integer","enum":[5,15,30]},"LanguageCode":{"type":"string","enum":["en-US","en-GB","en-AU","en-NZ","es","de","fr","it-IT","pt"]},"OutputParameters":{"type":"object","properties":{"aspectRatio":{"$ref":"#/components/schemas/AspectRatio"},"duration":{"$ref":"#/components/schemas/Duration"}},"required":["aspectRatio","duration"]},"Customization":{"type":"object","properties":{"instructions":{"type":"string"},"vibe":{"type":"string","enum":["Fun","Neutral","Professional","Laid-Back","Inspiring"]},"languageCode":{"type":"string","$ref":"#/components/schemas/LanguageCode"}}},"VideoGenerationRequest":{"type":"object","properties":{"topicId":{"type":"string","format":"uuid"},"topic":{"$ref":"#/components/schemas/Topic"},"customerMetadata":{"type":"string"},"accountGuid":{"type":"string","format":"uuid"},"outputParameters":{"$ref":"#/components/schemas/OutputParameters"},"templateVariantId":{"type":"string"},"customization":{"$ref":"#/components/schemas/Customization"},"webhookUrl":{"type":"string","format":"uri"},"title":{"type":"string","description":"Optional title to set on the generated video."}},"required":["accountGuid"]},"VideoGenerationAccepted":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"videoId":{"type":"string","format":"uuid"},"topicId":{"type":"string","format":"uuid"},"previewUrl":{"type":"string","format":"uri"},"editUrl":{"type":"string","format":"uri"}},"required":["requestId","videoId","topicId","previewUrl","editUrl"]},"VideoStatus":{"type":"string","enum":["PENDING","PROCESSING","COMPLETE","FAILED"]},"VideoGenerationStatus":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"videoId":{"type":"string","format":"uuid"},"status":{"$ref":"#/components/schemas/VideoStatus"},"customerMetadata":{"type":"string"},"error":{"$ref":"#/components/schemas/ApiError"}},"required":["requestId","videoId","status"]},"VideoDetails":{"type":"object","properties":{"videoId":{"type":"string","format":"uuid"},"title":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"previewUrl":{"type":"string","format":"uri"},"editUrl":{"type":"string","format":"uri"},"aspectRatio":{"$ref":"#/components/schemas/AspectRatio"},"duration":{"$ref":"#/components/schemas/Duration"},"variantSlug":{"type":"string"}},"required":["videoId","title","createdAt","updatedAt","previewUrl","editUrl"]},"VideoTransferErrorCode":{"type":"string","enum":["NOT_FOUND","VALIDATION_ERROR","TRANSFER_FAILED"]},"VideoTransferRequest":{"type":"object","properties":{"sourceAccountGuid":{"type":"string","format":"uuid"},"targetAccountGuid":{"type":"string","format":"uuid"},"videoGuids":{"type":"array","items":{"type":"string","format":"uuid"}},"customerMetadata":{"type":"string"}},"required":["sourceAccountGuid","targetAccountGuid","videoGuids"]},"VideoTransferError":{"type":"object","properties":{"videoGuid":{"type":"string","format":"uuid"},"code":{"$ref":"#/components/schemas/VideoTransferErrorCode"},"message":{"type":"string"}},"required":["videoGuid","code","message"]},"VideoTransferResponse":{"type":"object","properties":{"transferredCount":{"type":"integer"},"transferredVideoGuids":{"type":"array","items":{"type":"string","format":"uuid"}},"transferErrors":{"type":"array","items":{"$ref":"#/components/schemas/VideoTransferError"}}},"required":["transferredCount","transferredVideoGuids","transferErrors"]},"VideoEditorGrantRequest":{"type":"object","properties":{"editorAccountGuid":{"type":"string","format":"uuid","description":"Account being granted edit access. Must belong to the same partner as the video."},"isRevokable":{"type":"boolean","description":"Whether the video's owner can remove the grant in the Waymark app.\nDefaults to true. Set to false when your integration manages the grant\nand the owner should not be able to remove it. Grants can always be\nremoved through this API.\n"}},"required":["editorAccountGuid"]},"VideoEditor":{"type":"object","properties":{"guid":{"type":"string","format":"uuid"},"videoGuid":{"type":"string","format":"uuid"},"accountGuid":{"type":"string","format":"uuid","description":"Account that has edit access via this grant."},"grantedAt":{"type":"string","format":"date-time"},"isRevokable":{"type":"boolean","description":"Whether the video's owner can remove this grant in the Waymark app."}},"required":["guid","videoGuid","accountGuid","grantedAt","isRevokable"]},"VideoEditorListResponse":{"type":"object","properties":{"editors":{"type":"array","items":{"$ref":"#/components/schemas/VideoEditor"}}},"required":["editors"]}},"responses":{"InternalServerError":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"BadRequest":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"Conflict":{"description":"Duplicate request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"NotFound":{"description":"Content not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}},"Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}},"securitySchemes":{"api-key":{"type":"apiKey","name":"x-api-key","in":"header"},"authorization":{"type":"apiKey","name":"Authorization","in":"header","x-amazon-apigateway-authtype":"cognito_user_pools","x-amazon-apigateway-authorizer":{"type":"cognito_user_pools","providerARNs":["arn:aws:cognito-idp:us-east-2:973273415135:userpool/us-east-2_KeNYA9rB2"]}}}},"servers":[{"url":"https://api.waymark.com/v1"}]}