{"openapi":"3.1.0","info":{"title":"Sevalla API docs","version":"1.0.0"},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key authentication. Pass your API key as a Bearer token in the Authorization header."}},"schemas":{}},"paths":{"/validate":{"get":{"operationId":"validateApiKeyV2","summary":"Validate API key","tags":["Authentication"],"description":"Validate the provided API key and return its details including name, expiration, associated company, and current status.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","description":"Name of the API key","example":"My API Key"},"expires_at":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Expiration timestamp in milliseconds, or null if no expiration","example":1738195200000},"company":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Company ID associated with the API key","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"status":{"type":"string","description":"Current status of the API key","example":"active"}},"required":["name","expires_at","company","status"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/applications":{"get":{"operationId":"listApplicationsV2","summary":"Get applications","tags":["Applications"],"description":"Retrieve a list of all applications accessible in a company.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"query","name":"company","required":true,"description":"Company ID"},{"schema":{"default":10,"example":10,"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false,"description":"Maximum items per response"},{"schema":{"default":0,"example":0,"type":"integer","minimum":0,"maximum":10000},"in":"query","name":"offset","required":false,"description":"Pagination offset"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"object","properties":{"apps":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the application","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"name":{"type":"string","minLength":1,"maxLength":64,"description":"Unique name of the application","example":"my-app"},"display_name":{"type":"string","minLength":1,"maxLength":255,"description":"Display name of the application","example":"My Application"},"status":{"anyOf":[{"type":"string","enum":["deploymentInProgress","deploymentFailed","deploymentSuccess","deleting","appDeletionFailed","deploymentCancelled"]},{"type":"null"}],"example":"deploymentSuccess"}},"required":["id","name","display_name","status"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}},"required":["apps"],"additionalProperties":false}},"required":["company"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/applications/{id}":{"get":{"operationId":"getApplicationV2","summary":"Get application","tags":["Applications"],"description":"Fetch detailed information about a specific application by its unique identifier.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"app":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the application","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"name":{"type":"string","minLength":1,"maxLength":64,"description":"Unique name of the application","example":"my-app"},"display_name":{"type":"string","minLength":1,"maxLength":255,"description":"Display name of the application","example":"My Application"},"hibernation_enabled":{"type":"boolean","description":"Whether hibernation is enabled","example":false},"hibernate_after_seconds":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Seconds before hibernation","example":3600},"status":{"anyOf":[{"type":"string","enum":["deploymentInProgress","deploymentFailed","deploymentSuccess","deleting","appDeletionFailed","deploymentCancelled"]},{"type":"null"}],"example":"deploymentSuccess"},"deployments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the deployment","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"branch":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Git branch of the deployment","example":"main"},"repo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Repository URL","example":"https://github.com/user/repo"},"commit_message":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Commit message","example":"feat: add new feature"},"created_at":{"type":"number","description":"Creation timestamp in milliseconds","example":1738195200000}},"required":["id","branch","repo_url","commit_message","created_at"],"additionalProperties":false}},"processes":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the process","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"key":{"type":"string","description":"Unique key of the process","example":"web"}},"required":["id","key"],"additionalProperties":false}},"internal_connections":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the internal connection","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"app":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"name":{"type":"string","example":"my-app"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}],"description":"Connected application"},"database":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"name":{"type":"string","example":"my-database"}},"required":["id","name"],"additionalProperties":false},{"type":"null"}],"description":"Connected database"}},"required":["id","app","database"],"additionalProperties":false}}},"required":["id","name","display_name","hibernation_enabled","hibernate_after_seconds","status","deployments","processes","internal_connections"],"additionalProperties":false}},"required":["app"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}},"delete":{"operationId":"deleteApplicationV2","summary":"Delete application","tags":["Applications"],"description":"Permanently delete an application and all related resources.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}},"put":{"operationId":"updateApplicationV2","summary":"Update application","tags":["Applications"],"description":"Update properties or settings of an existing application.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"display_name":{"description":"Display name of the application","example":"My Application","type":"string","minLength":1,"maxLength":64},"auto_deploy":{"description":"Whether auto deploy is enabled","example":true,"type":"boolean"},"default_branch":{"description":"Default git branch","example":"main","type":"string","minLength":1},"hibernation_enabled":{"description":"Whether hibernation is enabled","example":false,"type":"boolean"},"hibernate_after_seconds":{"description":"Seconds before hibernation","example":3600,"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"build_path":{"description":"Build path","example":".","type":"string"},"build_type":{"description":"Build type (dockerfile, pack, nixpacks, railpack)","example":"nixpacks","type":"string","enum":["dockerfile","pack","nixpacks","railpack"]},"docker_file_path":{"description":"Dockerfile path","example":"Dockerfile","type":"string"},"docker_context":{"description":"Docker context path","example":".","type":"string"}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"app":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the application","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"name":{"type":"string","minLength":1,"maxLength":64,"description":"Unique name of the application","example":"my-app"},"status":{"anyOf":[{"type":"string","enum":["deploymentInProgress","deploymentFailed","deploymentSuccess","deleting","appDeletionFailed","deploymentCancelled"]},{"type":"null"}],"example":"deploymentSuccess"},"updated_at":{"type":"number","description":"Last updated timestamp in milliseconds","example":1738195200000},"build_path":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Build path","example":"."},"build_type":{"type":"string","enum":["dockerfile","pack","nixpacks","railpack"],"description":"Build type (dockerfile, pack, nixpacks, railpack)","example":"nixpacks"},"docker_file_path":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Dockerfile path","example":"Dockerfile"},"docker_context":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Docker context path","example":"."},"display_name":{"type":"string","minLength":1,"maxLength":255,"description":"Display name of the application","example":"My Application"},"auto_deploy":{"type":"boolean","description":"Whether auto deploy is enabled","example":true},"default_branch":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Default git branch","example":"main"},"hibernation_enabled":{"type":"boolean","description":"Whether hibernation is enabled","example":false},"hibernate_after_seconds":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"null"}],"description":"Seconds before hibernation","example":3600}},"required":["id","name","status","updated_at","build_path","build_type","docker_file_path","docker_context","display_name","auto_deploy","default_branch","hibernation_enabled","hibernate_after_seconds"],"additionalProperties":false}},"required":["app"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/applications/promote":{"post":{"operationId":"promoteApplicationV2","summary":"Promote application","tags":["Applications"],"description":"Promote an application in a pipeline to the next stage.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"source_app_id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Source application ID to promote from","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"target_app_ids":{"minItems":1,"type":"array","items":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"description":"Target application IDs to promote to"}},"required":["source_app_id","target_app_ids"],"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"promote":{"type":"array","items":{"type":"object","properties":{"target_app_id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Target application ID","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"deployment_id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Created deployment ID","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"}},"required":["target_app_id","deployment_id"],"additionalProperties":false}}},"required":["promote"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/applications/{id}/clear-cache":{"post":{"operationId":"clearCacheV2","summary":"Clear cache","tags":["Networking"],"description":"Clear the edge cache for your application to instantly update cached resources.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"isSuccess":{"type":"boolean","example":true}},"required":["isSuccess"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/applications/{id}/internal-connections":{"post":{"operationId":"createInternalConnectionV2","summary":"Create internal connection","tags":["Networking"],"description":"Create an internal connection between an application and another resource (application or database) within the same region. Connections are bidirectional, so only one connection can exist between a given pair of services - creating it again in either direction returns 409.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"target_id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the target resource","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"target_type":{"type":"string","enum":["appResource","dbResource"],"description":"Type of the target resource (appResource or dbResource)","example":"dbResource"}},"required":["target_id","target_type"]}}}},"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true,"description":"Unique identifier for the source application"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"string","description":"Result status of the operation","example":"success"}},"required":["result"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/applications/{id}/cdn/toggle-status":{"post":{"operationId":"toggleCdnV2","summary":"Toggle CDN","tags":["Networking"],"description":"Enable or disable CDN for your application to optimize content delivery.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"isTurnedOn":{"type":"boolean","example":true}},"required":["isTurnedOn"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/applications/{id}/edge-cache/toggle-status":{"post":{"operationId":"toggleEdgeCacheV2","summary":"Toggle edge cache","tags":["Networking"],"description":"Toggle edge caching for improved application performance and lower latency.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"isTurnedOn":{"type":"boolean","example":true}},"required":["isTurnedOn"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/applications/processes/{id}":{"get":{"operationId":"getProcessV2","summary":"Get process","tags":["Processes"],"description":"Get information about the running processes for a specific application.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"process":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the process","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Process type (web, worker, job, cron)","example":"web"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Display name of the process","example":"Web Process"},"instance_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"Number of running instances (deprecated)","example":1},"scaling_strategy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["type","config"],"additionalProperties":false},{"type":"null"}],"description":"Scaling strategy configuration"},"resource_type_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Resource type name","example":"standard-1"},"entrypoint":{"type":"string","description":"Process entrypoint command","example":"npm start"},"internal_hostname":{"type":"string","description":"Internal cluster hostname","example":"my-app-web.my-app.svc.cluster.local"},"internal_port":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"Internal port","example":8080}},"required":["id","type","display_name","instance_count","scaling_strategy","resource_type_name","entrypoint","internal_hostname","internal_port"],"additionalProperties":false}},"required":["process"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}},"put":{"operationId":"updateProcessV2","summary":"Update process","tags":["Processes"],"description":"Update or scale the running processes of an application.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scaling_strategy":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["manual"]},"config":{"type":"object","properties":{"instanceCount":{"type":"number","minimum":0,"maximum":50}},"required":["instanceCount"]}},"required":["type","config"]},{"type":"object","properties":{"type":{"type":"string","enum":["horizontal"]},"config":{"type":"object","properties":{"minInstanceCount":{"type":"number","minimum":1,"maximum":50},"maxInstanceCount":{"type":"number","minimum":1,"maximum":50},"targetCpuPercent":{"type":"number","minimum":1,"maximum":100},"targetMemoryPercent":{"type":"number","minimum":1,"maximum":100},"scaleUpIntervalSeconds":{"type":"number","minimum":1,"maximum":60000},"scaleUpIncrement":{"type":"number","minimum":1,"maximum":5},"scaleDownIntervalSeconds":{"type":"number","minimum":1,"maximum":60000},"scaleDownIncrement":{"type":"number","minimum":1,"maximum":5}},"required":["minInstanceCount","maxInstanceCount"]}},"required":["type","config"]}]},"entrypoint":{"type":"string"}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"process":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the process","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"app_id":{"type":"string","description":"Application identifier","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Display name of the process","example":"Web Process"},"entrypoint":{"type":"string","description":"Process entrypoint command","example":"npm start"},"scaling_strategy":{"anyOf":[{"type":"object","properties":{"type":{"type":"string"},"config":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["type","config"],"additionalProperties":false},{"type":"null"}],"description":"Scaling strategy configuration"},"updated_at":{"type":"number","description":"Last updated timestamp in milliseconds","example":1738195200000},"created_at":{"type":"number","description":"Creation timestamp in milliseconds","example":1738195200000}},"required":["id","app_id","display_name","entrypoint","scaling_strategy","updated_at","created_at"],"additionalProperties":false}},"required":["process"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/applications/deployments/{id}":{"get":{"operationId":"getDeploymentV2","summary":"Get deployment","tags":["Deployments"],"description":"Retrieve a deployment and details for a specific application.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"deployment":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the deployment","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"app_id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Application ID for the deployment","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"repo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Repository URL","example":"https://github.com/user/repo"},"branch":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Git branch of the deployment","example":"main"},"commit_sha":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Commit SHA","example":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"},"author_login":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Author login","example":"johndoe"},"author_img":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Author avatar image URL","example":"https://avatars.githubusercontent.com/u/12345"},"commit_message":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Commit message","example":"feat: add new feature"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Deployment status","example":"deploymentSuccess"},"created_at":{"type":"number","description":"Creation timestamp in milliseconds","example":1738195200000}},"required":["id","app_id","repo_url","branch","commit_sha","author_login","author_img","commit_message","status","created_at"],"additionalProperties":false}},"required":["deployment"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/applications/deployments":{"post":{"operationId":"startDeploymentV2","summary":"Start deployment","tags":["Deployments"],"description":"Start a new deployment for your application using this endpoint.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"app_id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Application ID to deploy","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"branch":{"description":"Git branch to deploy","example":"main","type":"string"},"docker_image":{"description":"Docker image to deploy","example":"my-image:latest","type":"string"},"is_restart":{"default":false,"description":"Whether this is a restart deployment","example":false,"type":"boolean"}},"required":["app_id"],"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"deployment":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the deployment","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"}},"required":["id"],"additionalProperties":false}},"required":["deployment"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/company/{id}/paas-usage":{"get":{"operationId":"getUsageV2","summary":"Get usage","tags":["Company"],"description":"Retrieve daily PaaS usage data for a company within a billing period.","parameters":[{"schema":{"default":0,"example":0,"type":"integer","minimum":-5,"maximum":0},"in":"query","name":"period_offset","required":false,"description":"Period offset for usage data. 0 is the current period, -1 is the previous period, and so on."},{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true,"description":"Company identifier"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"object","properties":{"paas_usage":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the usage record","example":"usage_12345"},"date":{"type":"number","description":"Unix timestamp in milliseconds","example":1738195200000},"category":{"type":"string","enum":["appCompute","appStorage","appBuild","appBandwidth","staticSiteBuild","staticSiteBandwidth","db","objectStorage","loadBalancer","loadBalancerBandwidth"],"description":"Resource usage type","example":"appCompute"},"id_resource":{"type":"string","description":"Resource identifier","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"usage":{"type":"number","description":"Usage amount","example":24.5},"cost":{"type":"number","description":"Cost in USD","example":12.75}},"required":["id","date","category","id_resource","usage","cost"],"additionalProperties":false}}},"required":["paas_usage"],"additionalProperties":false}},"required":["company"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/company/{id}/users":{"get":{"operationId":"getCompanyUsersV2","summary":"Get company users","tags":["Company"],"description":"Retrieve the list of users belonging to a company.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true,"description":"Company identifier"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"object","properties":{"users":{"type":"array","items":{"type":"object","properties":{"user":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the user","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"email":{"type":"string","format":"email","pattern":"^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$","description":"User email address","example":"user@example.com"},"image":{"type":"string","format":"uri","description":"User avatar image URL","example":"https://avatars.githubusercontent.com/u/12345"},"full_name":{"type":"string","description":"User full name","example":"John Doe"}},"required":["id","email","image","full_name"],"additionalProperties":false}},"required":["user"],"additionalProperties":false}}},"required":["users"],"additionalProperties":false}},"required":["company"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/databases":{"get":{"operationId":"listDatabasesV2","summary":"Get databases","tags":["Databases"],"description":"Retrieve a list of all databases available to a company.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"query","name":"company","required":true,"description":"Company ID"},{"schema":{"default":10,"example":10,"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false,"description":"Maximum items per response"},{"schema":{"default":0,"example":0,"type":"integer","minimum":0,"maximum":10000},"in":"query","name":"offset","required":false,"description":"Pagination offset"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"object","properties":{"databases":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the database","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"name":{"type":"string","description":"Unique name of the database","example":"my-database"},"display_name":{"type":"string","description":"Display name of the database","example":"My Database"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Current database status","example":"ready"},"updated_at":{"type":"number","description":"Last updated timestamp in milliseconds","example":1738195200000},"type":{"type":"string","description":"Database engine type","example":"postgresql"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Database engine version","example":"16"},"resource_type_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Resource type tier name","example":"db-standard-1"}},"required":["id","name","display_name","status","updated_at","type","version","resource_type_name"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}},"required":["databases"],"additionalProperties":false}},"required":["company"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}},"post":{"operationId":"createDatabaseV2","summary":"Create database","tags":["Databases"],"description":"Create a new database with the specified configuration.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"location":{"type":"string","description":"Cluster location identifier","example":"europe-west1"},"resource_type":{"type":"string","description":"Resource type name","example":"db-standard-1"},"display_name":{"type":"string","minLength":2,"maxLength":64,"description":"Display name for the database","example":"My Database"},"db_name":{"type":"string","minLength":2,"maxLength":100,"description":"Database name","example":"mydb"},"db_password":{"type":"string","minLength":4,"maxLength":100,"description":"Database password","example":"securepassword123"},"type":{"type":"string","enum":["postgresql","mariadb","mysql","mongodb","redis","valkey"],"description":"Database engine type","example":"postgresql"},"version":{"type":"string","description":"Database engine version. Available versions depend on the database type and the selected cluster. Unsupported versions are rejected with a 400 response.","example":"16"},"db_user":{"description":"Database user (required for non-Redis/Valkey)","example":"dbuser","type":"string","minLength":2,"maxLength":32,"pattern":"^[a-zA-Z0-9_\\-+]+$"}},"required":["location","resource_type","display_name","db_name","db_password","type","version"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"database":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the database","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"}},"required":["id"],"additionalProperties":false}},"required":["database"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/databases/{id}":{"get":{"operationId":"getDatabaseV2","summary":"Get database","tags":["Databases"],"description":"Get details for a specific database, including configuration and status.","parameters":[{"schema":{"default":true,"example":true,"type":"boolean"},"in":"query","name":"internal","required":false,"description":"Include internal connection info"},{"schema":{"default":true,"example":true,"type":"boolean"},"in":"query","name":"external","required":false,"description":"Include external connection info"},{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"database":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the database","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"name":{"type":"string","description":"Unique name of the database","example":"my-database"},"display_name":{"type":"string","description":"Display name of the database","example":"My Database"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Current database status","example":"ready"},"created_at":{"type":"number","description":"Creation timestamp in milliseconds","example":1738195200000},"memory_limit":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"Memory limit in MB","example":1024},"cpu_limit":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"CPU limit in millicores","example":1000},"storage_size":{"anyOf":[{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},{"type":"null"}],"description":"Storage size in MB","example":10240},"type":{"type":"string","description":"Database engine type","example":"postgresql"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Database engine version","example":"16"},"resource_type_name":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Resource type tier name","example":"db-standard-1"},"cluster":{"anyOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"location":{"anyOf":[{"type":"string"},{"type":"null"}],"example":"europe-west1"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"example":"Europe West 1"}},"required":["id","location","display_name"],"additionalProperties":false},{"type":"null"}]},"internal_hostname":{"example":"my-database.internal","anyOf":[{"type":"string"},{"type":"null"}]},"internal_port":{"example":"5432","anyOf":[{"type":"string"},{"type":"null"}]},"internal_connection_string":{"example":"postgresql://user:pass@my-database.internal:5432/mydb","type":"string"},"internal_connections":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"type":{"type":"string","example":"appResource"}},"required":["id","type"],"additionalProperties":false}},"data":{"type":"object","properties":{"db_name":{"anyOf":[{"type":"string"},{"type":"null"}],"example":"mydb"},"db_password":{"anyOf":[{"type":"string"},{"type":"null"}],"example":"********"},"db_root_password":{"anyOf":[{"type":"string"},{"type":"null"}],"example":"********"},"db_user":{"anyOf":[{"type":"string"},{"type":"null"}],"example":"dbuser"}},"required":["db_name","db_password","db_root_password","db_user"],"additionalProperties":false},"external_connection_string":{"example":"postgresql://user:pass@ext-host.sevalla.com:5432/mydb","type":"string"},"external_hostname":{"example":"ext-host.sevalla.com","anyOf":[{"type":"string"},{"type":"null"}]},"external_port":{"example":"5432","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name","display_name","status","created_at","memory_limit","cpu_limit","storage_size","type","version","resource_type_name","cluster"],"additionalProperties":false}},"required":["database"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}},"put":{"operationId":"updateDatabaseV2","summary":"Update database","tags":["Databases"],"description":"Update settings or metadata for an existing database.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"resource_type":{"description":"Resource type name","example":"db-standard-1","type":"string"},"display_name":{"description":"New display name","example":"My Database","type":"string","minLength":2,"maxLength":64}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"database":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the database","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"display_name":{"type":"string","description":"Display name of the database","example":"My Database"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Current database status","example":"ready"}},"required":["id","display_name","status"],"additionalProperties":false}},"required":["database"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}},"delete":{"operationId":"deleteDatabaseV2","summary":"Delete database","tags":["Databases"],"description":"Delete a database and all its associated data permanently.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string"}},"required":["message"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/pipelines":{"get":{"operationId":"listPipelinesV2","summary":"Get pipelines","tags":["Pipelines"],"description":"List all pipeline configurations and workflows available to a company.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"query","name":"company","required":true,"description":"Company ID"},{"schema":{"default":10,"example":10,"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false,"description":"Maximum items per response"},{"schema":{"default":0,"example":0,"type":"integer","minimum":0,"maximum":10000},"in":"query","name":"offset","required":false,"description":"Pagination offset"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"object","properties":{"pipelines":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the pipeline","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"display_name":{"type":"string","description":"Display name of the pipeline","example":"Production Pipeline"},"stages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the pipeline stage","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"display_name":{"type":"string","description":"Display name of the pipeline stage","example":"Staging"},"type":{"type":"string","description":"Stage type","example":"staging"}},"required":["id","display_name","type"],"additionalProperties":false}}},"required":["id","display_name","stages"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}},"required":["pipelines"],"additionalProperties":false}},"required":["company"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/pipelines/{id}/create-preview-app":{"post":{"operationId":"createPreviewAppV2","summary":"Create preview app","tags":["Pipelines"],"description":"Create a preview application in a pipeline.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"branch":{"type":"string","minLength":1,"description":"Git branch for the preview app","example":"feature/my-branch"},"pull_request_number":{"description":"Pull request number","example":42,"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["branch"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"app":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the application","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"name":{"type":"string","minLength":1,"maxLength":64,"description":"Unique name of the application","example":"my-app"},"display_name":{"type":"string","minLength":1,"maxLength":255,"description":"Display name of the application","example":"My Application"}},"required":["id","name","display_name"],"additionalProperties":false}},"required":["app"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/static-sites":{"get":{"operationId":"listStaticSitesV2","summary":"Get static sites","tags":["Static sites"],"description":"Retrieve a list of all static sites accessible in a company.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"query","name":"company","required":true,"description":"Company ID"},{"schema":{"default":10,"example":10,"type":"integer","minimum":1,"maximum":100},"in":"query","name":"limit","required":false,"description":"Maximum items per response"},{"schema":{"default":0,"example":0,"type":"integer","minimum":0,"maximum":10000},"in":"query","name":"offset","required":false,"description":"Pagination offset"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"company":{"type":"object","properties":{"static_sites":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the static site","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"name":{"type":"string","description":"Unique name of the static site","example":"my-static-site"},"display_name":{"type":"string","description":"Display name of the static site","example":"My Static Site"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Current static site status","example":"ready"}},"required":["id","name","display_name","status"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}},"required":["static_sites"],"additionalProperties":false}},"required":["company"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/static-sites/{id}":{"get":{"operationId":"getStaticSiteV2","summary":"Get static site","tags":["Static sites"],"description":"Fetch detailed information about a specific static site by its unique identifier.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"static_site":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the static site","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"name":{"type":"string","description":"Unique name of the static site","example":"my-static-site"},"display_name":{"type":"string","description":"Display name of the static site","example":"My Static Site"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Current static site status","example":"ready"},"repo_url":{"type":"string","description":"Repository URL","example":"https://github.com/user/static-site"},"default_branch":{"type":"string","description":"Default git branch","example":"main"},"auto_deploy":{"type":"boolean","description":"Whether auto deploy is enabled","example":true},"remote_repository_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Remote repository identifier","example":"123456"},"git_repository_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Git repository identifier","example":"789012"},"git_type":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Git provider type (github, bitbucket, gitlab)","example":"github"},"hostname":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Site hostname","example":"my-site.sevalla.app"},"build_command":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Build command","example":"npm run build"},"created_at":{"type":"number","description":"Creation timestamp in milliseconds","example":1738195200000},"updated_at":{"type":"number","description":"Last updated timestamp in milliseconds","example":1738195200000},"deployments":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the deployment","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Deployment status","example":"success"},"repo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Repository URL","example":"https://github.com/user/static-site"},"branch":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Git branch of the deployment","example":"main"},"commit_message":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Commit message","example":"feat: add new feature"},"created_at":{"type":"number","description":"Creation timestamp in milliseconds","example":1738195200000}},"required":["id","status","repo_url","branch","commit_message","created_at"],"additionalProperties":false}}},"required":["id","name","display_name","status","repo_url","default_branch","auto_deploy","remote_repository_id","git_repository_id","git_type","hostname","build_command","created_at","updated_at","deployments"],"additionalProperties":false}},"required":["static_site"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}},"delete":{"operationId":"deleteStaticSiteV2","summary":"Delete static site","tags":["Static sites"],"description":"Permanently delete a static site and all related resources.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"Deletion confirmation message","example":"Static site is being deleted"}},"required":["message"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}},"put":{"operationId":"updateStaticSiteV2","summary":"Update static site","tags":["Static sites"],"description":"Update properties or settings of an existing static site.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"display_name":{"description":"Display name of the static site","example":"My Static Site","type":"string","minLength":1},"auto_deploy":{"description":"Whether auto deploy is enabled","example":true,"type":"boolean"},"default_branch":{"description":"Default git branch","example":"main","type":"string","minLength":1},"build_command":{"description":"Build command","example":"npm run build","anyOf":[{"type":"string"},{"type":"null"}]},"node_version":{"description":"Node.js version","example":"20","anyOf":[{"type":"string"},{"type":"null"}]},"published_directory":{"description":"Published output directory","example":"dist","anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"static_site":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the static site","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"display_name":{"type":"string","description":"Display name of the static site","example":"My Static Site"},"auto_deploy":{"type":"boolean","description":"Whether auto deploy is enabled","example":true},"default_branch":{"type":"string","description":"Default git branch","example":"main"},"build_command":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Build command","example":"npm run build"},"node_version":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Node.js version","example":"20"},"published_directory":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Published output directory","example":"dist"},"updated_at":{"type":"number","description":"Last updated timestamp in milliseconds","example":1738195200000},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Current static site status","example":"ready"}},"required":["id","display_name","auto_deploy","default_branch","build_command","node_version","published_directory","updated_at","status"],"additionalProperties":false}},"required":["static_site"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/static-sites/deployments/{id}":{"get":{"operationId":"getStaticSiteDeploymentV2","summary":"Get static site deployment","tags":["Static Site Deployments"],"description":"Retrieve deployment details for a specific static site deployment.","parameters":[{"schema":{"type":"string","format":"uuid","pattern":"^([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)$","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"deployment":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the deployment","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"static_site_id":{"anyOf":[{"type":"string","format":"uuid","pattern":"^([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)$","description":"Static site ID for the deployment","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},{"type":"null"}]},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Deployment status","example":"success"},"repo_url":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Repository URL","example":"https://github.com/user/static-site"},"branch":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Git branch of the deployment","example":"main"},"author_login":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Author login","example":"johndoe"},"author_img":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Author avatar image URL","example":"https://avatars.githubusercontent.com/u/12345"},"commit_sha":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Commit SHA","example":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"},"commit_message":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Commit message","example":"feat: add new feature"},"cloud_build_id":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Cloud build identifier","example":"build-12345"},"created_at":{"type":"number","description":"Creation timestamp in milliseconds","example":1738195200000},"updated_at":{"type":"number","description":"Last updated timestamp in milliseconds","example":1738195200000},"finished_at":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Completion timestamp in milliseconds","example":1738195500000},"started_at":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Start timestamp in milliseconds","example":1738195200000}},"required":["id","static_site_id","status","repo_url","branch","author_login","author_img","commit_sha","commit_message","cloud_build_id","created_at","updated_at","finished_at","started_at"],"additionalProperties":false}},"required":["deployment"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}},"/static-sites/deployments":{"post":{"operationId":"deployStaticSiteV2","summary":"Deploy static site","tags":["Static Site Deployments"],"description":"Manually or programmatically deploy a static site.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"static_site_id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"ID of the static site to deploy","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"branch":{"description":"Git branch to deploy","example":"main","type":"string","minLength":1}},"required":["static_site_id"]}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"deployment":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([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)$","description":"Unique identifier for the deployment","example":"fb5e5168-4281-4bec-94c5-0d1584e9e657"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Deployment status","example":"success"}},"required":["id","status"],"additionalProperties":false}},"required":["deployment"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Not found"},"status":{"type":"number","example":404},"data":{"type":"object","properties":{"code":{"description":"Error tracking code for support reference","example":"err_12345","type":"string"},"message":{"description":"Instructions for the user","example":"The requested resource was not found","type":"string"}},"additionalProperties":false}},"required":["message","status"],"additionalProperties":false}}}}}}}},"servers":[{"url":"https://api.sevalla.com/v2"}],"security":[{"bearerAuth":[]}]}