{"id":28506748,"url":"https://github.com/temporalio/cloud-api","last_synced_at":"2026-02-10T20:10:05.201Z","repository":{"id":199364926,"uuid":"675843679","full_name":"temporalio/cloud-api","owner":"temporalio","description":" Temporal cloud gRPC API and proto files ","archived":false,"fork":false,"pushed_at":"2026-02-10T00:24:39.000Z","size":494,"stargazers_count":11,"open_issues_count":10,"forks_count":6,"subscribers_count":8,"default_branch":"main","last_synced_at":"2026-02-10T01:16:49.823Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Makefile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/temporalio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2023-08-07T21:31:40.000Z","updated_at":"2026-02-09T22:58:52.000Z","dependencies_parsed_at":"2025-02-11T23:33:41.098Z","dependency_job_id":"b62f6ced-87f3-45c7-9853-4ded03cd9905","html_url":"https://github.com/temporalio/cloud-api","commit_stats":null,"previous_names":["temporalio/api-cloud","temporalio/cloud-api"],"tags_count":18,"template":false,"template_full_name":null,"purl":"pkg:github/temporalio/cloud-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/temporalio%2Fcloud-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/temporalio%2Fcloud-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/temporalio%2Fcloud-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/temporalio%2Fcloud-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/temporalio","download_url":"https://codeload.github.com/temporalio/cloud-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/temporalio%2Fcloud-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29314704,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-10T17:48:59.043Z","status":"ssl_error","status_checked_at":"2026-02-10T17:45:37.240Z","response_time":65,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-08T20:06:17.300Z","updated_at":"2026-02-10T20:10:05.177Z","avatar_url":"https://github.com/temporalio.png","language":"Makefile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Temporal Cloud Operations API (Public Preview)\n\n\u003e aka the Cloud Ops API  \n\u003e These apis (proto files) are currently offered as a Public Preview. While they are production worthy, they are subject to change. Please reach out to Temporal Support if you have questions.\n\n## How to use\n\nTo use the Cloud Ops API in your project, preform the following 4 steps:\n1. Copy over the protobuf files under [temporal](temporal) directory to your desired project directory\n2. Use [gRPC](https://grpc.io/docs/) to compile and generate code in your desired programming language, typically handled as a part of your code build process\n3. Create a client connection in your code using a Temporal Cloud API Key (see [Samples](#samples) below)\n4. Use the Cloud Operations API services to automate Cloud Operations, such as creating users or namespaces\n\n### API Version\n\nThe client is expected to pass in a `temporal-cloud-api-version` header with the api version identifier with every request it makes to the apis. The backend will use the version to safely mutate resources. The `temporal:versioning:min_version` label specifies the minimum version of the API that supports the field.\n\nCurrent Version `v0.7.1`\n\n### URL\n\nThe grpc URL the clients should connect to:\n```\nsaas-api.tmprl.cloud:443\n```\n\n## Samples\n\nRefer to the [cloud-samples-go](https://github.com/temporalio/cloud-samples-go/blob/main/cmd/worker/README.md) sample repository for how to use the cloud ops api in Go.\n\u003e This sample demonstrates how to automate Temporal Cloud operations using Temporal Workflows that make Cloud Ops API requests within Workflow Activities ([Worker Sample README](https://github.com/temporalio/cloud-samples-go/tree/main/cmd/worker)).  \n\u003e See [here](https://github.com/temporalio/cloud-samples-go/blob/60d5cbca8696c87fb184efc56f5ae117561213d2/client/api/client.go#L16) for a quick reference showing you how to connect to Temporal Cloud with an API Key for the Cloud Ops API in Go.\n\nRefer to the [temporal-cloud-api-client-typescript](https://github.com/steveandroulakis/temporal-cloud-api-client-typescript) sample repository for how to use the cloud ops api in Typescript.  \nRefer to the [temporal-cloud-api-client-java](https://github.com/steveandroulakis/temporal-cloud-api-client-java) sample repository for how to use the cloud ops api in Java.  \nRefer to the [temporal-cloud-api-client-kotlin](https://github.com/steveandroulakis/temporal-cloud-api-client-kotlin) sample repository for how to use the cloud ops api in Kotlin.\n\u003e The Java, Typescript, and Kotlin sample apps all provide a simple HTML UI that demonstrates how to use the Cloud Ops API to CRUD Namespaces and Users.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftemporalio%2Fcloud-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftemporalio%2Fcloud-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftemporalio%2Fcloud-api/lists"}