> For the complete documentation index, see [llms.txt](https://docs.bbchain.com.br/bbchain-ebs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bbchain.com.br/bbchain-ebs/bbchain-ebs-pt/para-desenvolvedores/api-reference/network-management/apps/app-version-web-adapter.md).

# App Version Web Adapter

## POST /v2/apps/{app-id}/versions

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"v0"},"servers":[{"url":"https://apps-p-bk-api.saas.ebs.bbchain.network","description":"Generated server url"}],"paths":{"/v2/apps/{app-id}/versions":{"post":{"tags":["app-version-web-adapter"],"operationId":"createAppVersionV2","parameters":[{"name":"app-id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"version","in":"query","required":true,"schema":{"type":"string"}},{"name":"kind","in":"query","required":true,"schema":{"type":"string"}},{"name":"dltType","in":"query","required":true,"schema":{"type":"string"}},{"name":"apiTechnology","in":"query","required":false,"schema":{"type":"string"}},{"name":"apiTechnologyName","in":"query","required":false,"schema":{"type":"string"}},{"name":"apiVars","in":"query","required":false,"schema":{"type":"string"}},{"name":"id","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"declaredVersion","in":"query","required":false,"schema":{"type":"string"}},{"name":"targetPlatformVersion","in":"query","required":false,"schema":{"type":"string"}},{"name":"minimumPlatformVersion","in":"query","required":false,"schema":{"type":"string"}},{"name":"currentStatus","in":"query","required":false,"schema":{"type":"string","enum":["ACTIVATED","DISABLED","ACTIVATING","DEACTIVATING","ERROR","DELETING","DELETED"]}},{"name":"appId","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"workflowsFileName","in":"query","required":false,"schema":{"type":"string"}},{"name":"contractsFileName","in":"query","required":false,"schema":{"type":"string"}},{"name":"apiFileName","in":"query","required":false,"schema":{"type":"string"}},{"name":"configFileName","in":"query","required":false,"schema":{"type":"string"}},{"name":"certificateFileName","in":"query","required":false,"schema":{"type":"string"}},{"name":"binName","in":"query","required":false,"schema":{"type":"string"}},{"name":"abiName","in":"query","required":false,"schema":{"type":"string"}},{"name":"constructorVars","in":"query","required":false,"schema":{"type":"string"}},{"name":"ptahContractName","in":"query","required":false,"schema":{"type":"string"}},{"name":"contractCall","in":"query","required":false,"schema":{"type":"string"}},{"name":"contractConfirmationCall","in":"query","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"protocols":{"type":"array","items":{"$ref":"#/components/schemas/AppProtocol"}},"workflows":{"type":"string","format":"binary"},"contracts":{"type":"string","format":"binary"},"apiFile":{"type":"array","items":{"type":"string","format":"binary"}},"startScript":{"type":"string","format":"binary"},"config":{"type":"string","format":"binary"},"certificate":{"type":"string","format":"binary"},"binFile":{"type":"string","format":"binary"},"abiFile":{"type":"string","format":"binary"},"ptahContract":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppVersionSelectorV2"}}}}}}}},"components":{"schemas":{"AppProtocol":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"tag":{"type":"string"},"name":{"type":"string"},"icon":{"type":"string"}},"required":["icon","id","name","tag"]},"AppVersionSelectorV2":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"declaredVersion":{"type":"string"},"targetPlatformVersion":{"type":"string"},"minimumPlatformVersion":{"type":"string"},"currentStatus":{"type":"string","enum":["ACTIVATED","DISABLED","ACTIVATING","DEACTIVATING","ERROR","DELETING","DELETED"]},"appId":{"type":"integer","format":"int64"},"workflows":{"type":"string","format":"binary"},"contracts":{"type":"string","format":"binary"},"apiFile":{"type":"array","items":{"type":"string","format":"binary"}},"startScript":{"type":"string","format":"binary"},"config":{"type":"string","format":"binary"},"certificate":{"type":"string","format":"binary"},"workflowsFileName":{"type":"string"},"contractsFileName":{"type":"string"},"apiFileName":{"type":"string"},"configFileName":{"type":"string"},"certificateFileName":{"type":"string"},"binName":{"type":"string"},"binFile":{"type":"string","format":"binary"},"abiName":{"type":"string"},"abiFile":{"type":"string","format":"binary"},"constructorVars":{"type":"string"},"ptahContract":{"type":"string","format":"binary"},"ptahContractName":{"type":"string"},"contractCall":{"type":"string"},"contractConfirmationCall":{"type":"string"},"version":{"type":"string"},"kind":{"type":"string","enum":["API","SMART_CONTRACT"]},"dltType":{"type":"string"},"protocols":{"type":"array","items":{"$ref":"#/components/schemas/AppProtocol"}},"apiTechnology":{"type":"string"},"apiTechnologyName":{"type":"string"},"apiVars":{"type":"string"}},"required":["dltType","kind","version"]}}}}
```

## GET /v1/apps/{app-id}/versions

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"v0"},"servers":[{"url":"https://apps-p-bk-api.saas.ebs.bbchain.network","description":"Generated server url"}],"paths":{"/v1/apps/{app-id}/versions":{"get":{"tags":["app-version-web-adapter"],"operationId":"getAppVersions","parameters":[{"name":"app-id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"availableProtocols","in":"query","required":false,"schema":{"type":"array","items":{"type":"string"}}},{"name":"orderBy","in":"query","required":false,"schema":{"type":"string"}},{"name":"order","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":0}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","format":"int32","default":10}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppVersionsPageDTO"}}}}}}}},"components":{"schemas":{"AppVersionsPageDTO":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/AppVersionPageDataDTO"}},"metadata":{"$ref":"#/components/schemas/PageMetadata"}}},"AppVersionPageDataDTO":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"kind":{"type":"string","enum":["SMART_CONTRACT","API"]},"version":{"type":"string"},"description":{"type":"string"},"protocol":{"type":"string"},"status":{"type":"string","enum":["ACTIVATED","DISABLED","ACTIVATING","DEACTIVATING","ERROR","DELETING","DELETED"]}}},"PageMetadata":{"type":"object","properties":{"page":{"type":"integer","format":"int32"},"pageSize":{"type":"integer","format":"int32"},"totalItems":{"type":"integer","format":"int32"},"totalPages":{"type":"integer","format":"int32"}}}}}}
```

## POST /v1/apps/{app-id}/versions

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"v0"},"servers":[{"url":"https://apps-p-bk-api.saas.ebs.bbchain.network","description":"Generated server url"}],"paths":{"/v1/apps/{app-id}/versions":{"post":{"tags":["app-version-web-adapter"],"operationId":"createAppVersion","parameters":[{"name":"app-id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"version","in":"query","required":true,"schema":{"type":"string"}},{"name":"kind","in":"query","required":true,"schema":{"type":"string"}},{"name":"dltType","in":"query","required":true,"schema":{"type":"string"}},{"name":"apiTechnology","in":"query","required":false,"schema":{"type":"string"}},{"name":"apiTechnologyName","in":"query","required":false,"schema":{"type":"string"}},{"name":"apiVars","in":"query","required":false,"schema":{"type":"string"}},{"name":"id","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"declaredVersion","in":"query","required":false,"schema":{"type":"string"}},{"name":"targetPlatformVersion","in":"query","required":false,"schema":{"type":"string"}},{"name":"minimumPlatformVersion","in":"query","required":false,"schema":{"type":"string"}},{"name":"currentStatus","in":"query","required":false,"schema":{"type":"string","enum":["ACTIVATED","DISABLED","ACTIVATING","DEACTIVATING","ERROR","DELETING","DELETED"]}},{"name":"appId","in":"query","required":false,"schema":{"type":"integer","format":"int64"}},{"name":"workflowsFileName","in":"query","required":false,"schema":{"type":"string"}},{"name":"contractsFileName","in":"query","required":false,"schema":{"type":"string"}},{"name":"apiFileName","in":"query","required":false,"schema":{"type":"string"}},{"name":"configFileName","in":"query","required":false,"schema":{"type":"string"}},{"name":"certificateFileName","in":"query","required":false,"schema":{"type":"string"}},{"name":"binName","in":"query","required":false,"schema":{"type":"string"}},{"name":"abiName","in":"query","required":false,"schema":{"type":"string"}},{"name":"constructorVars","in":"query","required":false,"schema":{"type":"string"}},{"name":"ptahContractName","in":"query","required":false,"schema":{"type":"string"}},{"name":"contractCall","in":"query","required":false,"schema":{"type":"string"}},{"name":"contractConfirmationCall","in":"query","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"protocols":{"type":"array","items":{"$ref":"#/components/schemas/AppProtocol"}},"workflows":{"type":"string","format":"binary"},"contracts":{"type":"string","format":"binary"},"apiFile":{"type":"string","format":"binary"},"config":{"type":"string","format":"binary"},"certificate":{"type":"string","format":"binary"},"binFile":{"type":"string","format":"binary"},"abiFile":{"type":"string","format":"binary"},"ptahContract":{"type":"string","format":"binary"}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppVersionSelector"}}}}}}}},"components":{"schemas":{"AppProtocol":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"tag":{"type":"string"},"name":{"type":"string"},"icon":{"type":"string"}},"required":["icon","id","name","tag"]},"AppVersionSelector":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"declaredVersion":{"type":"string"},"targetPlatformVersion":{"type":"string"},"minimumPlatformVersion":{"type":"string"},"currentStatus":{"type":"string","enum":["ACTIVATED","DISABLED","ACTIVATING","DEACTIVATING","ERROR","DELETING","DELETED"]},"appId":{"type":"integer","format":"int64"},"workflows":{"type":"string","format":"binary"},"contracts":{"type":"string","format":"binary"},"apiFile":{"type":"string","format":"binary"},"config":{"type":"string","format":"binary"},"certificate":{"type":"string","format":"binary"},"workflowsFileName":{"type":"string"},"contractsFileName":{"type":"string"},"apiFileName":{"type":"string"},"configFileName":{"type":"string"},"certificateFileName":{"type":"string"},"binName":{"type":"string"},"binFile":{"type":"string","format":"binary"},"abiName":{"type":"string"},"abiFile":{"type":"string","format":"binary"},"constructorVars":{"type":"string"},"ptahContract":{"type":"string","format":"binary"},"ptahContractName":{"type":"string"},"contractCall":{"type":"string"},"contractConfirmationCall":{"type":"string"},"version":{"type":"string"},"kind":{"type":"string","enum":["API","SMART_CONTRACT"]},"dltType":{"type":"string"},"protocols":{"type":"array","items":{"$ref":"#/components/schemas/AppProtocol"}},"apiTechnology":{"type":"string"},"apiTechnologyName":{"type":"string"},"apiVars":{"type":"string"}},"required":["dltType","kind","version"]}}}}
```

## GET /v1/apps/{app-id}/versions/{version-id}

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"v0"},"servers":[{"url":"https://apps-p-bk-api.saas.ebs.bbchain.network","description":"Generated server url"}],"paths":{"/v1/apps/{app-id}/versions/{version-id}":{"get":{"tags":["app-version-web-adapter"],"operationId":"getAppVersion","parameters":[{"name":"app-id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"version-id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppVersionSelector"}}}}}}}},"components":{"schemas":{"AppVersionSelector":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"declaredVersion":{"type":"string"},"targetPlatformVersion":{"type":"string"},"minimumPlatformVersion":{"type":"string"},"currentStatus":{"type":"string","enum":["ACTIVATED","DISABLED","ACTIVATING","DEACTIVATING","ERROR","DELETING","DELETED"]},"appId":{"type":"integer","format":"int64"},"workflows":{"type":"string","format":"binary"},"contracts":{"type":"string","format":"binary"},"apiFile":{"type":"string","format":"binary"},"config":{"type":"string","format":"binary"},"certificate":{"type":"string","format":"binary"},"workflowsFileName":{"type":"string"},"contractsFileName":{"type":"string"},"apiFileName":{"type":"string"},"configFileName":{"type":"string"},"certificateFileName":{"type":"string"},"binName":{"type":"string"},"binFile":{"type":"string","format":"binary"},"abiName":{"type":"string"},"abiFile":{"type":"string","format":"binary"},"constructorVars":{"type":"string"},"ptahContract":{"type":"string","format":"binary"},"ptahContractName":{"type":"string"},"contractCall":{"type":"string"},"contractConfirmationCall":{"type":"string"},"version":{"type":"string"},"kind":{"type":"string","enum":["API","SMART_CONTRACT"]},"dltType":{"type":"string"},"protocols":{"type":"array","items":{"$ref":"#/components/schemas/AppProtocol"}},"apiTechnology":{"type":"string"},"apiTechnologyName":{"type":"string"},"apiVars":{"type":"string"}},"required":["dltType","kind","version"]},"AppProtocol":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"tag":{"type":"string"},"name":{"type":"string"},"icon":{"type":"string"}},"required":["icon","id","name","tag"]}}}}
```

## DELETE /v1/apps/{app-id}/versions/{version-id}

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"v0"},"servers":[{"url":"https://apps-p-bk-api.saas.ebs.bbchain.network","description":"Generated server url"}],"paths":{"/v1/apps/{app-id}/versions/{version-id}":{"delete":{"tags":["app-version-web-adapter"],"operationId":"deleteAppVersion","parameters":[{"name":"app-id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"version-id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppVersionSelector"}}}}}}}},"components":{"schemas":{"AppVersionSelector":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"declaredVersion":{"type":"string"},"targetPlatformVersion":{"type":"string"},"minimumPlatformVersion":{"type":"string"},"currentStatus":{"type":"string","enum":["ACTIVATED","DISABLED","ACTIVATING","DEACTIVATING","ERROR","DELETING","DELETED"]},"appId":{"type":"integer","format":"int64"},"workflows":{"type":"string","format":"binary"},"contracts":{"type":"string","format":"binary"},"apiFile":{"type":"string","format":"binary"},"config":{"type":"string","format":"binary"},"certificate":{"type":"string","format":"binary"},"workflowsFileName":{"type":"string"},"contractsFileName":{"type":"string"},"apiFileName":{"type":"string"},"configFileName":{"type":"string"},"certificateFileName":{"type":"string"},"binName":{"type":"string"},"binFile":{"type":"string","format":"binary"},"abiName":{"type":"string"},"abiFile":{"type":"string","format":"binary"},"constructorVars":{"type":"string"},"ptahContract":{"type":"string","format":"binary"},"ptahContractName":{"type":"string"},"contractCall":{"type":"string"},"contractConfirmationCall":{"type":"string"},"version":{"type":"string"},"kind":{"type":"string","enum":["API","SMART_CONTRACT"]},"dltType":{"type":"string"},"protocols":{"type":"array","items":{"$ref":"#/components/schemas/AppProtocol"}},"apiTechnology":{"type":"string"},"apiTechnologyName":{"type":"string"},"apiVars":{"type":"string"}},"required":["dltType","kind","version"]},"AppProtocol":{"type":"object","properties":{"id":{"type":"integer","format":"int64"},"tag":{"type":"string"},"name":{"type":"string"},"icon":{"type":"string"}},"required":["icon","id","name","tag"]}}}}
```

## PATCH /v1/apps/{app-id}/versions/{version-id}

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"v0"},"servers":[{"url":"https://apps-p-bk-api.saas.ebs.bbchain.network","description":"Generated server url"}],"paths":{"/v1/apps/{app-id}/versions/{version-id}":{"patch":{"tags":["app-version-web-adapter"],"operationId":"updateAppVersion","parameters":[{"name":"app-id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"version-id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppPatchDTO"}}},"required":true},"responses":{"200":{"description":"OK"}}}}},"components":{"schemas":{"AppPatchDTO":{"type":"object","properties":{"declaredVersion":{"type":"string"},"changeActivationStatus":{"type":"boolean"}}}}}}
```

## GET /v1/apps/{app-id}/versions/{version-id}/download

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"v0"},"servers":[{"url":"https://apps-p-bk-api.saas.ebs.bbchain.network","description":"Generated server url"}],"paths":{"/v1/apps/{app-id}/versions/{version-id}/download":{"get":{"tags":["app-version-web-adapter"],"operationId":"downloadAppVersion","parameters":[{"name":"app-id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}},{"name":"version-id","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}},"application/json":{"schema":{"type":"string","format":"binary"}}}}}}}}}
```