{
 "kind": "api",
 "slug": "temporal",
 "path": "apis/temporal/",
 "name": "Temporal Cloud",
 "maker": "Temporal",
 "density": "full",
 "crumbs": [
  [
   "APIs",
   "apis/"
  ],
  [
   "Integrations and automation",
   "apis/automation/"
  ]
 ],
 "lead": "Long processes that survive crashes.",
 "chips": [
  {
   "label": "Integrations and automation",
   "path": "apis/automation/"
  }
 ],
 "primary": {
  "label": "Copy prompt for your agent",
  "copy": "Build my order process as a Temporal workflow with temporalio at a fixed version: each outside call (payment, email, shipping) as an Activity with a retry policy, test it on temporal server start-dev, then read TEMPORAL_ADDRESS, TEMPORAL_NAMESPACE and TEMPORAL_API_KEY from .env for Temporal Cloud."
 },
 "links": [
  {
   "label": "Website",
   "href": "https://temporal.io"
  },
  {
   "label": "Pricing",
   "href": "https://temporal.io/pricing"
  },
  {
   "label": "GitHub",
   "href": "https://github.com/temporalio/sdk-python"
  }
 ],
 "track": "Outages, price changes and new versions on your dashboard",
 "verdicts": [
  {
   "key": "price",
   "label": "Price",
   "value": "Open source",
   "status": "yes",
   "sub": "Run it yourself for free",
   "quote": "Pay-As-You-Go Starting at $50 per million actions Get started for free Free $150 credits for 90 days",
   "note": "Free tier: $150 credits for 90 days, no base monthly fee. As reported on the official pricing page, checked Oct 13, 2026.",
   "src": "https://temporal.io/pricing"
  },
  {
   "key": "commercial",
   "label": "Commercial use",
   "value": "With conditions",
   "status": "cond",
   "sub": null,
   "quote": "Customer shall retain all right, title and interest in and to the Customer Data, including all intellectual property rights therein.",
   "note": "Temporal Cloud is used under Temporal's terms on a paid account; the open-source server and SDKs are MIT and free for commercial use.",
   "src": "https://temporal.io/terms-of-service"
  },
  {
   "key": "key",
   "label": "Key & sign-up",
   "value": "API key, server only",
   "status": "info",
   "sub": "Env var TEMPORAL_API_KEY (with TEMPORAL_ADDRESS and TEMPORAL_NAMESPACE)",
   "quote": "TEMPORAL_API_KEY: Your API key value. Required if you are using API key authentication.",
   "note": "API key (or mTLS certificate) per Namespace, passed to Client.connect with tls=True",
   "src": "https://docs.temporal.io/develop/python/client/temporal-client.md"
  },
  {
   "key": "agent",
   "label": "Agent access",
   "value": "Docs for agents",
   "status": "info",
   "sub": "llms.txt · SDK",
   "quote": "Sign-in is required through MCP OAuth with Google or GitHub, and anonymous requests are rejected.",
   "note": " Our agent check: 3 of 6 (Nov 13, 2026).",
   "src": "https://docs.temporal.io/llms.txt"
  }
 ],
 "vfoot": "Checked against the maker's official pages, pricing on Oct 13, 2026.",
 "blocks": [
  {
   "id": "overview",
   "nav": "Overview",
   "h2": "What Temporal Cloud does",
   "parts": [
    {
     "t": "prose",
     "text": "Temporal lets your app run long, multi-step processes, such as an order, a sign-up or an AI assistant's task, that carry on where they stopped after a crash or restart. Your own code runs on your machines, and Temporal Cloud is the hosted service that keeps track of each step. Temporal itself is open source and can also be run on your own servers."
    },
    {
     "t": "list",
     "items": [
      "Temporal Cloud is one of 17 APIs in the Integrations and automation category on AgentGid.",
      "At $0.05 per 1,000 requests it is the 2nd cheapest of the 4 that publish a per-request price (cheapest: Trigger.dev, $0.025).",
      "Its cheapest paid plan ($50 a month) is the 11th cheapest of the 15 here with a monthly plan.",
      "It is one of 16 that can be started for free.",
      "6 of them ship an official MCP server; Temporal Cloud does not.",
      "Its official SDK is the 2nd most downloaded in the category (11.5M a week)."
     ],
     "muted": true
    },
    {
     "t": "h3",
     "text": "What people build with it"
    },
    {
     "t": "uses",
     "items": [
      {
       "title": "Payments and orders that never half-finish",
       "text": "Charge the card, reserve stock and book delivery as one process; if a step fails, it is retried or the earlier steps are undone.",
       "idea": false
      },
      {
       "title": "Processes that wait days for a person",
       "text": "An approval, a document review or a booking that pauses until someone clicks, then carries on, even if your servers restarted meanwhile.",
       "idea": false
      },
      {
       "title": "AI assistants that resume after a crash",
       "text": "Each model call and tool call is a saved step, so a long agent task picks up the conversation instead of starting over and paying twice.",
       "idea": false
      },
      {
       "title": "Data and video processing pipelines",
       "text": "Split a big job, such as processing thousands of files, into many steps that run in parallel and resume without redoing finished work.",
       "idea": false
      },
      {
       "title": "Scheduled jobs and maintenance",
       "text": "Nightly reports, cleanups or account checks run on a schedule, with each run visible and retried when it fails.",
       "idea": false
      },
      {
       "title": "Welcome emails spread over weeks",
       "text": "Send a series of onboarding messages days apart for each new user, with no cron table to maintain and no lost steps after a restart.",
       "idea": true
      }
     ]
    }
   ]
  },
  {
   "id": "popularity",
   "nav": "Popularity",
   "h2": "Temporal Cloud popularity",
   "parts": [
    {
     "t": "stats",
     "items": [
      {
       "n": "11.3M",
       "l": "SDK downloads a week",
       "d": "+19.9% on the 4-week average",
       "up": true
      },
      {
       "n": "43",
       "l": "public agent repos use its SDK"
      },
      {
       "n": "1,252",
       "l": "GitHub stars, temporalio/sdk-python"
      }
     ]
    },
    {
     "t": "small",
     "text": "SDK downloads from npm and PyPI, weekly. Numbers as of Nov 17, 2026."
    }
   ]
  },
  {
   "id": "pricing",
   "nav": "Pricing and limits",
   "h2": "Pricing",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Free tier",
       "v": "$150 credits for 90 days, no base monthly fee"
      },
      {
       "l": "Cheapest plan",
       "v": "$50 a month"
      },
      {
       "l": "Usage price",
       "v": "$50 per million actions"
      },
      {
       "l": "Plans",
       "v": "Added automatically: its SDK was in 16 of the public agent repos we sampled when it was added. Prices read from the official pricing page."
      }
     ]
    },
    {
     "t": "h3",
     "text": "What one action costs"
    },
    {
     "t": "table",
     "head": [
      "Action",
      "Price"
     ],
     "num": true,
     "rows": [
      [
       "1 million actions (pay-as-you-go, first 5M)",
       "$50"
      ],
      [
       "A test workflow run of 10,000 actions, including 10% support",
       "$0.55"
      ],
      [
       "1 GB-hour of active storage (open workflows)",
       "$0.042"
      ]
     ]
    },
    {
     "t": "more",
     "items": [
      {
       "title": "Price history",
       "items": [
        "A year of the pricing page in the Internet Archive (8 months): the lowest monthly figure went from $100 (2025-12) to $100 (2026-09)."
       ]
      }
     ]
    },
    {
     "t": "small",
     "text": "As reported on the official pricing page, checked Oct 13, 2026. Prices change: confirm before you buy.",
     "link": "temporal.io/pricing",
     "href": "https://temporal.io/pricing"
    }
   ]
  },
  {
   "id": "limits",
   "nav": null,
   "spy_as": "pricing",
   "h2": "Limits",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "All Temporal Cloud namespaces (On-Demand)",
       "v": "500 actions per second by default, scaling up with the last 7 days of use",
       "src": "https://docs.temporal.io/evaluate/cloud/limits.md"
      },
      {
       "l": "All Temporal Cloud namespaces",
       "v": "2 MB per request payload",
       "src": "https://docs.temporal.io/evaluate/cloud/limits.md"
      },
      {
       "l": "All Temporal Cloud namespaces",
       "v": "Finished workflow history kept 30 days by default, settable from 1 to 90 days",
       "src": "https://docs.temporal.io/evaluate/cloud/limits.md"
      }
     ]
    },
    {
     "t": "small",
     "text": "From the official docs.",
     "link": "docs.temporal.io/evaluate/cloud/limits.md",
     "href": "https://docs.temporal.io/evaluate/cloud/limits.md"
    }
   ]
  },
  {
   "id": "access",
   "nav": "Access and terms",
   "h2": "Key and access",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "How it signs in",
       "v": "API key (or mTLS certificate) per Namespace, passed to Client.connect with tls=True"
      },
      {
       "l": "Environment variable",
       "v": "TEMPORAL_API_KEY (with TEMPORAL_ADDRESS and TEMPORAL_NAMESPACE)",
       "code": true
      },
      {
       "l": "Safe in browser code",
       "v": "No, keep it on your server",
       "status": "no"
      },
      {
       "l": "Card at sign-up",
       "v": "Yes"
      }
     ]
    },
    {
     "t": "h3",
     "text": "Steps only a person can do"
    },
    {
     "t": "list",
     "items": [
      "Sign up for Temporal Cloud with a credit card (or through AWS or GCP Marketplace) and create a Namespace. Use the Namespace address and ID from the Namespaces tab as TEMPORAL_ADDRESS and TEMPORAL_NAMESPACE.",
      "Create an API key and save the secret right away; it is shown only once. Put it in .env as TEMPORAL_API_KEY (kept out of git) and connect with tls=True.",
      "Install the Temporal CLI for local development (brew install temporal on macOS). Run temporal server start-dev and test workflows locally before using the cloud."
     ]
    }
   ]
  },
  {
   "id": "terms",
   "nav": null,
   "spy_as": "access",
   "h2": "Commercial use and your data",
   "parts": [
    {
     "t": "prose",
     "text": "Temporal Cloud is a paid service under Temporal's terms, and you keep the rights to the data you send. Temporal itself is open source under the MIT license, free to run on your own servers."
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "In a paid app",
       "v": "With conditions",
       "status": "cond",
       "sub": "Temporal Cloud is used under Temporal's terms on a paid account; the open-source server and SDKs are MIT and free for commercial use.",
       "quote": "Customer shall retain all right, title and interest in and to the Customer Data, including all intellectual property rights therein.",
       "src": "https://temporal.io/terms-of-service"
      },
      {
       "l": "redistribute-files",
       "v": "With conditions",
       "status": "cond",
       "sub": "The MIT code may be shipped with the notice kept; access to the hosted service itself may not be resold.",
       "quote": "The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.",
       "src": "https://github.com/temporalio/temporal/blob/main/LICENSE"
      },
      {
       "l": "client-work",
       "v": "With conditions",
       "status": "cond",
       "sub": "Fine with the open-source version; on Temporal Cloud, the client's account and data stay under the client's own contract.",
       "quote": "Customer is solely responsible for the selection of the appropriate processing region based on localization requirements.",
       "src": "https://temporal.io/terms-of-service"
      },
      {
       "l": "Trains on what you send",
       "v": "“Data conversion runs on your Workers and Clients, so Temporal Cloud cannot see or decrypt your data.”",
       "quote": null,
       "src": "https://docs.temporal.io/evaluate/cloud/security.md"
      },
      {
       "l": "Keeps your data",
       "v": "“Temporal Cloud sets the default Retention Period to 30 days.”",
       "quote": null,
       "src": "https://docs.temporal.io/evaluate/cloud/limits.md"
      },
      {
       "l": "Where data is stored",
       "v": "“Create Namespaces in a region close to where you host your Workers to reduce latency.”",
       "quote": null,
       "src": "https://docs.temporal.io/evaluate/cloud/regions.md"
      }
     ]
    }
   ]
  },
  {
   "id": "errors",
   "nav": null,
   "spy_as": "access",
   "h2": "Errors to handle",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "ResourceExhausted",
       "v": "You went over the namespace's actions or requests per second and Temporal Cloud throttled the call.",
       "sub": "The SDK retries it; if it keeps failing, handle the failure, slow down or raise capacity."
      },
      {
       "l": "Request unauthorized",
       "v": "The API key is wrong, or a new key has not reached the namespace yet.",
       "sub": "Retry with backoff for a few minutes; then check the key, its permissions and the namespace."
      },
      {
       "l": "WORKFLOW_TASK_FAILED_CAUSE_PAYLOADS_TOO_LARGE",
       "v": "An input or result is bigger than the 2 MB payload limit.",
       "sub": "Store large data elsewhere (for example in object storage) and pass a reference; deploy the fix and the workflow continues."
      },
      {
       "l": "Context: deadline exceeded",
       "v": "A request to the Temporal service could not finish in time (network, overload or clock skew).",
       "sub": "Retry; check the network and worker clocks; on Temporal Cloud open a support ticket with the workflow IDs."
      },
      {
       "l": "NondeterminismError",
       "v": "Workflow code did something that differs between runs, such as calling the network or reading the clock directly.",
       "sub": "Move that work into an Activity and redeploy; the workflow waits until it is fixed."
      }
     ]
    }
   ]
  },
  {
   "id": "agent",
   "nav": "For agents",
   "h2": "Use it from an agent",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Our agent check",
       "v": "3 of 6: llms.txt yes, OpenAPI no, SDK yes, MCP no, status page no, AI assistants allowed yes",
       "sub": "Checked Nov 13, 2026."
      },
      {
       "l": "MCP server",
       "v": "Temporal Docs MCP Server (documentation search only)",
       "sub": "Sign-in is required through MCP OAuth with Google or GitHub, and anonymous requests are rejected."
      },
      {
       "l": "PyPI",
       "v": "pip install temporalio",
       "code": true
      }
     ]
    },
    {
     "t": "h3",
     "text": "Instructions in its docs to check first"
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "The docs say",
       "v": "“For questions about Temporal (Workflows, Activities, Workers, SDKs, Temporal Cloud, the CLI, self-hosting), you can query the documentation directly instead of relying on web search or training data.”",
       "sub": "The page asks agents to send the user's questions and a one-sentence job-to-be-done to a Temporal search endpoint. Ask the person first, and never send project details; reading the .md pages is enough."
      },
      {
       "l": "The docs say",
       "v": "“If a page is wrong, out of date, or missing something you needed, or Temporal behaves differently from what the docs say, you can report it to the Temporal docs team.”",
       "sub": "Sending a report is a message on the person's behalf; do it only if they ask."
      }
     ]
    }
   ]
  },
  {
   "id": "alternatives",
   "nav": "Alternatives",
   "h2": "Alternatives",
   "parts": [
    {
     "t": "alts",
     "items": [
      {
       "name": "Temporal Cloud",
       "me": true,
       "facts": [
        "$0.05 / 1k requests",
        "Free tier"
       ]
      },
      {
       "name": "Inngest",
       "why": "Pick Inngest for event-driven background functions with durable steps, at a similar per-step list price ($0.05 per 1,000 in our catalog on 2026-11-10).",
       "path": "apis/inngest/",
       "facts": [
        "$0.05 / 1k requests",
        "Free tier"
       ]
      },
      {
       "name": "Trigger.dev",
       "why": "Pick Trigger.dev for long-running TypeScript tasks on a managed platform that also runs your code, listed at $0.025 per 1,000 in our catalog on 2026-11-10.",
       "path": "apis/trigger-dev/",
       "facts": [
        "$0.025 / 1k requests",
        "Free tier"
       ]
      },
      {
       "name": "Prefect Cloud",
       "why": "Pick Prefect Cloud when your work is mostly scheduled data pipelines in Python that you want to schedule and monitor.",
       "path": "apis/prefect/",
       "facts": [
        "Free plan",
        "Free tier"
       ]
      }
     ],
     "more": "All integrations and automation APIs",
     "more_path": "apis/automation/"
    }
   ]
  },
  {
   "id": "start",
   "nav": "Get started",
   "h2": "Get started",
   "parts": [
    {
     "t": "prompt",
     "text": "Build my order process as a Temporal workflow with temporalio at a fixed version: each outside call (payment, email, shipping) as an Activity with a retry policy, test it on temporal server start-dev, then read TEMPORAL_ADDRESS, TEMPORAL_NAMESPACE and TEMPORAL_API_KEY from .env for Temporal Cloud."
    },
    {
     "t": "steps",
     "items": [
      {
       "text": "Install the Python package in a virtual environment (there are also Go, Java, TypeScript, .NET, PHP, Ruby and Rust packages).",
       "code": "pip install temporalio",
       "src": "https://docs.temporal.io/develop/python/set-up-your-local-python.md"
      },
      {
       "text": "Start the free local development server; it runs the web screen at localhost:8233 and stores data only in memory.",
       "code": "temporal server start-dev",
       "src": "https://docs.temporal.io/develop/python/set-up-your-local-python.md"
      },
      {
       "text": "For Temporal Cloud, sign up, create a Namespace with an API key, and connect with these environment variables.",
       "code": "export TEMPORAL_ADDRESS=<namespace>.<account>.tmprl.cloud:7233\nexport TEMPORAL_NAMESPACE=<namespace>.<account>\nexport TEMPORAL_API_KEY=<key-secret>",
       "src": "https://docs.temporal.io/cloud/get-started.md"
      }
     ]
    },
    {
     "t": "h3",
     "text": "First request"
    },
    {
     "t": "tabs",
     "label": "First request",
     "items": [
      {
       "tab": "Request",
       "code": "import asyncio\nimport uuid\nfrom temporalio.client import Client\nasync def main():\n    client = await Client.connect(\"localhost:7233\")\n    result = await client.execute_workflow(\n        \"SayHelloWorkflow\",\n        \"Temporal\",\n        id=f\"say-hello-workflow-{uuid.uuid4()}\",\n        task_queue=\"my-task-queue\",\n    )\n    print(\"Workflow result:\", result)\nif __name__ == \"__main__\":\n    asyncio.run(main())",
       "intro": "starter.py from the Python quickstart (blank lines removed), against the free local dev server (temporal server start-dev) with worker.py running. For Temporal Cloud the same code connects with Client.connect(endpoint, namespace=..., api_key=..., tls=True)."
      },
      {
       "tab": "Response",
       "code": "Workflow result: Hello Temporal"
      }
     ]
    },
    {
     "t": "h3",
     "text": "Mistakes to avoid"
    },
    {
     "t": "mistakes",
     "items": [
      {
       "dont": "Calling an outside service, reading the clock or using random values directly inside workflow code.",
       "fix": "Put outside calls in Activities and use the workflow module's own helpers inside workflows.",
       "why": "Workflow code is replayed, so anything that changes between runs breaks it and the workflow stops until fixed."
      },
      {
       "dont": "Importing activity modules into the workflow file normally.",
       "fix": "Wrap those imports in with workflow.unsafe.imports_passed_through(), as the quickstart does.",
       "why": "Workflows run in a sandbox that re-imports the workflow file on each run."
      },
      {
       "dont": "Passing large files or long texts as workflow inputs or results.",
       "fix": "Store the data elsewhere and pass an ID or link.",
       "why": "Each request payload is limited to 2 MB on Temporal Cloud."
      },
      {
       "dont": "Starting workers right after creating a new API key.",
       "fix": "First check the key with a simple call (for example temporal workflow list) and retry with backoff, then start workers.",
       "why": "New keys reach the namespace asynchronously and can return Request unauthorized at first."
      },
      {
       "dont": "Letting an Activity retry forever on an error that will never fix itself, such as bad input.",
       "fix": "Raise ApplicationError with non_retryable=True for permanent errors.",
       "why": "Otherwise the step keeps retrying until its timeout."
      }
     ]
    }
   ]
  },
  {
   "id": "faq",
   "nav": "Questions",
   "h2": "Questions",
   "parts": [
    {
     "t": "faq",
     "items": [
      {
       "q": "Is there a free tier?",
       "a": "There is no free plan, but new accounts get $150 in credits for 90 days and no base monthly fee. Running Temporal locally or on your own servers is free.",
       "evidence": {
        "url": "https://temporal.io/pricing.md",
        "quote": "All new accounts receive $150 in free credits that expire after 90 days."
       }
      },
      {
       "q": "Does Temporal Cloud see my data?",
       "a": "It stores the inputs and results of each step. You can encrypt them on your side first, and then Temporal Cloud cannot read them.",
       "evidence": {
        "url": "https://docs.temporal.io/evaluate/cloud/security.md",
        "quote": "The optional Data Converter encrypts data before it's sent to Temporal Cloud and decrypts it on the way back."
       }
      },
      {
       "q": "Which languages can I write workflows in?",
       "a": "Go, Java, Python, TypeScript, .NET, PHP, Ruby and Rust, as listed on the pricing page.",
       "evidence": {
        "url": "https://temporal.io/pricing",
        "quote": "Go, Java, Python, TypeScript, .NET, PHP, Ruby, Rust - plus time-skipping tests."
       }
      },
      {
       "q": "What happens when a step fails?",
       "a": "Activities are retried automatically with backoff; you can mark errors that should not be retried so the step fails at once.",
       "evidence": {
        "url": "https://temporal.io/pricing",
        "quote": "Automatic retries with backoff, four timeout classes, heartbeating, and saga compensation."
       }
      },
      {
       "q": "Can my AI assistant read the docs?",
       "a": "Yes. Any docs page is available as Markdown by adding .md to its address, with an index at docs.temporal.io/llms.txt.",
       "evidence": {
        "url": "https://docs.temporal.io/llms.txt",
        "quote": "To fetch any page as raw Markdown, append `.md` to its URL path (e.g., `https://docs.temporal.io/workflows.md`)."
       }
      }
     ]
    }
   ]
  }
 ],
 "glance": [
  [
   "Maker",
   "Temporal"
  ],
  [
   "Category",
   "Integrations and automation"
  ],
  [
   "Price",
   "$0.05 / 1k requests"
  ],
  [
   "Plans from",
   "$50/mo"
  ],
  [
   "Official SDK",
   "PyPI temporalio"
  ],
  [
   "Latest SDK",
   "1.35.0 on npm"
  ],
  [
   "Agent check",
   "3 of 6"
  ],
  [
   "Pricing checked",
   "Oct 13, 2026"
  ]
 ],
 "good": [
  "Temporal Cloud does not run your code. You still run small programs, called workers, on your own servers that do the actual steps.",
  "Signing up needs a credit card, even for the free $150 credits; local development needs no account.",
  "You pay per action, such as each step started, timer or message, plus storage, plus 10% of usage for basic support."
 ],
 "checked_line": "Read by AgentGid from 25 official pages, card checked Nov 10, 2026; usage numbers update daily."
}