# val-town OpenAPI overview > Below is an overview of the val-town openapi in simple language. This API contains 52 endpoints. For more detailed information of an endpoint, visit https://oapis.org/summary/val-town/[idOrRoute] Val Town API v1 - https://api.val.town Val Town’s public API OpenAPI JSON endpoint: https://api.val.town/openapi.json ## alias Many API endpoints accept IDs instead of user-facing names. The alias endpoints let you convert between the user-facing name of a val or another object into an ID that can be used with other API endpoints - [aliasUsername](https://oapis.org/openapi/val-town/aliasUsername): GET https://api.val.town/v1/alias/{username} - - [aliasVal2](https://oapis.org/openapi/val-town/aliasVal2): GET https://api.val.town/v2/alias/vals/{username}/{val_name} - ## blobs Blobs - [v1blobsList](https://oapis.org/openapi/val-town/v1blobsList): GET https://api.val.town/v1/blob?prefix=string - - [v1blobsGet](https://oapis.org/openapi/val-town/v1blobsGet): GET https://api.val.town/v1/blob/{key} - - [v1blobsStore](https://oapis.org/openapi/val-town/v1blobsStore): POST https://api.val.town/v1/blob/{key} - - [v1blobsDelete](https://oapis.org/openapi/val-town/v1blobsDelete): DELETE https://api.val.town/v1/blob/{key} - - [v2blobsList](https://oapis.org/openapi/val-town/v2blobsList): GET https://api.val.town/v2/blob?prefix=string - - [v2blobsGet](https://oapis.org/openapi/val-town/v2blobsGet): GET https://api.val.town/v2/blob/{key} - - [v2blobsStore](https://oapis.org/openapi/val-town/v2blobsStore): POST https://api.val.town/v2/blob/{key} - - [v2blobsDelete](https://oapis.org/openapi/val-town/v2blobsDelete): DELETE https://api.val.town/v2/blob/{key} - ## connections - [](https://oapis.org/openapi/val-town/v3/connections/slack/token): POST https://api.val.town/v3/connections/slack/token - - [](https://oapis.org/openapi/val-town/v3/connections/google-docs/token): POST https://api.val.town/v3/connections/google-docs/token - ## emails Emails - [emailsSend](https://oapis.org/openapi/val-town/emailsSend): POST https://api.val.town/v1/email - ## envVarGroups - [environmentVariableGroupsList](https://oapis.org/openapi/val-town/environmentVariableGroupsList): GET https://api.val.town/v3/environment-variable-groups/?offset=integer&limit=integer&orgId=string - - [environmentVariableGroupsCreate](https://oapis.org/openapi/val-town/environmentVariableGroupsCreate): POST https://api.val.town/v3/environment-variable-groups/ - - [environmentVariableGroupsRename](https://oapis.org/openapi/val-town/environmentVariableGroupsRename): PUT https://api.val.town/v3/environment-variable-groups/{id} - - [environmentVariableGroupsDelete](https://oapis.org/openapi/val-town/environmentVariableGroupsDelete): DELETE https://api.val.town/v3/environment-variable-groups/{id} - - [environmentVariableGroupsGet](https://oapis.org/openapi/val-town/environmentVariableGroupsGet): GET https://api.val.town/v3/environment-variable-groups/{id}/environment-variables - - [environmentVariableGroupsCreateVariable](https://oapis.org/openapi/val-town/environmentVariableGroupsCreateVariable): POST https://api.val.town/v3/environment-variable-groups/{id}/environment-variables - - [environmentVariableGroupsUpsertVariable](https://oapis.org/openapi/val-town/environmentVariableGroupsUpsertVariable): POST https://api.val.town/v3/environment-variable-groups/{id}/environment-variables/{key} - - [environmentVariableGroupsVariableDelete](https://oapis.org/openapi/val-town/environmentVariableGroupsVariableDelete): DELETE https://api.val.town/v3/environment-variable-groups/{id}/environment-variables/{key} - ## files - [queryValFileById](https://oapis.org/openapi/val-town/queryValFileById): GET https://api.val.town/v2/files/{file_id} - ## me These endpoints give access to details and data from the requesting user. - [meGet](https://oapis.org/openapi/val-town/meGet): GET https://api.val.town/v1/me - - [meVals2](https://oapis.org/openapi/val-town/meVals2): GET https://api.val.town/v2/me/vals?offset=integer&limit=integer - ## orgs - [orgsList](https://oapis.org/openapi/val-town/orgsList): GET https://api.val.town/v2/orgs?offset=integer&limit=integer - - [orgsMembershipsList](https://oapis.org/openapi/val-town/orgsMembershipsList): GET https://api.val.town/v2/orgs/{org_id}/memberships - ## sqlite SQLite - [sqliteExecute](https://oapis.org/openapi/val-town/sqliteExecute): POST https://api.val.town/v1/sqlite/execute - - [sqliteBatch](https://oapis.org/openapi/val-town/sqliteBatch): POST https://api.val.town/v1/sqlite/batch - ## telemetry - [traceList](https://oapis.org/openapi/val-town/traceList): GET https://api.val.town/v1/telemetry/traces?file_id=string&branch_ids=array&direction=direction&start=string&end=string&limit=integer&order_by=order_by - - [logList](https://oapis.org/openapi/val-town/logList): GET https://api.val.town/v1/telemetry/logs?trace_ids=array&file_id=string&branch_ids=array&direction=direction&start=string&end=string&limit=integer - ## users Users - [usersGet](https://oapis.org/openapi/val-town/usersGet): GET https://api.val.town/v1/users/{user_id} - ## val - [](https://oapis.org/openapi/val-town/v3/val/viewer): GET https://api.val.town/v3/val/viewer - ## vals These endpoints let you get, create, and run vals. - [valEnvironmentVariablesList](https://oapis.org/openapi/val-town/valEnvironmentVariablesList): GET https://api.val.town/v2/vals/{val_id}/environment_variables/?offset=integer&limit=integer - - [valEnvironmentVariablesCreate](https://oapis.org/openapi/val-town/valEnvironmentVariablesCreate): POST https://api.val.town/v2/vals/{val_id}/environment_variables/ - - [valEnvironmentVariablesUpdate](https://oapis.org/openapi/val-town/valEnvironmentVariablesUpdate): PUT https://api.val.town/v2/vals/{val_id}/environment_variables/{key} - - [valEnvironmentVariablesDelete](https://oapis.org/openapi/val-town/valEnvironmentVariablesDelete): DELETE https://api.val.town/v2/vals/{val_id}/environment_variables/{key} - - [valEnvironmentVariableGroupsList](https://oapis.org/openapi/val-town/valEnvironmentVariableGroupsList): GET https://api.val.town/v2/vals/{val_id}/environment_variable_groups/?offset=integer&limit=integer - - [valEnvironmentVariableGroupsAttach](https://oapis.org/openapi/val-town/valEnvironmentVariableGroupsAttach): PUT https://api.val.town/v2/vals/{val_id}/environment_variable_groups/{group_id} - - [valEnvironmentVariableGroupsDetach](https://oapis.org/openapi/val-town/valEnvironmentVariableGroupsDetach): DELETE https://api.val.town/v2/vals/{val_id}/environment_variable_groups/{group_id} - - [valsGet2](https://oapis.org/openapi/val-town/valsGet2): GET https://api.val.town/v2/vals/{val_id} - - [projectsDelete2](https://oapis.org/openapi/val-town/projectsDelete2): DELETE https://api.val.town/v2/vals/{val_id} - - [valsList2](https://oapis.org/openapi/val-town/valsList2): GET https://api.val.town/v2/vals?privacy=privacy&user_id=string&cursor=string&limit=integer - - [valsCreate2](https://oapis.org/openapi/val-town/valsCreate2): POST https://api.val.town/v2/vals - - [branchesGet2](https://oapis.org/openapi/val-town/branchesGet2): GET https://api.val.town/v2/vals/{val_id}/branches/{branch_id} - - [branchesDelete2](https://oapis.org/openapi/val-town/branchesDelete2): DELETE https://api.val.town/v2/vals/{val_id}/branches/{branch_id} - - [branchesList2](https://oapis.org/openapi/val-town/branchesList2): GET https://api.val.town/v2/vals/{val_id}/branches?offset=integer&limit=integer - - [branchesCreate2](https://oapis.org/openapi/val-town/branchesCreate2): POST https://api.val.town/v2/vals/{val_id}/branches - - [valFilesGet2](https://oapis.org/openapi/val-town/valFilesGet2): GET https://api.val.town/v2/vals/{val_id}/files?version=integer&branch_id=string&path=string&recursive=boolean&offset=integer&limit=integer - - [filesCreate2](https://oapis.org/openapi/val-town/filesCreate2): POST https://api.val.town/v2/vals/{val_id}/files?branch_id=string&path=string - - [fileContentUpdate2](https://oapis.org/openapi/val-town/fileContentUpdate2): PUT https://api.val.town/v2/vals/{val_id}/files?branch_id=string&path=string - - [filesDelete2](https://oapis.org/openapi/val-town/filesDelete2): DELETE https://api.val.town/v2/vals/{val_id}/files?branch_id=string&path=string&recursive=boolean - - [filesContentGet2](https://oapis.org/openapi/val-town/filesContentGet2): GET https://api.val.town/v2/vals/{val_id}/files/content?version=integer&branch_id=string&path=string -