Skip to main content
GET
/
deployments
/
{deployment}
Get deployment
curl --request GET \
  --url https://api.example.com/deployments/{deployment}
{
  "created_at": "<string>",
  "http_version": "<string>",
  "id": "<string>",
  "max_protocol_version": 123,
  "min_protocol_version": 123,
  "protocol_type": "RequestResponse",
  "services": [
    {
      "deployment_id": "<string>",
      "handlers": [
        {
          "input_description": "<string>",
          "name": "<string>",
          "output_description": "<string>",
          "abort_timeout": "<string>",
          "documentation": "<string>",
          "enable_lazy_state": true,
          "idempotency_retention": "<string>",
          "inactivity_timeout": "<string>",
          "info": [
            {
              "message": "<string>",
              "code": "<string>"
            }
          ],
          "input_json_schema": "<unknown>",
          "journal_retention": "<string>",
          "metadata": {},
          "output_json_schema": "<unknown>",
          "public": true,
          "retry_policy": {
            "exponentiation_factor": 123,
            "initial_interval": "<string>",
            "max_attempts": 2,
            "max_interval": "<string>",
            "on_max_attempts": "Pause"
          },
          "ty": "Exclusive"
        }
      ],
      "name": "<string>",
      "revision": 1,
      "ty": "Service",
      "abort_timeout": "<string>",
      "documentation": "<string>",
      "enable_lazy_state": true,
      "idempotency_retention": "<string>",
      "inactivity_timeout": "<string>",
      "info": [
        {
          "message": "<string>",
          "code": "<string>"
        }
      ],
      "journal_retention": "<string>",
      "metadata": {},
      "public": true,
      "retry_policy": {
        "exponentiation_factor": 123,
        "initial_interval": "<string>",
        "max_attempts": 2,
        "max_interval": "<string>",
        "on_max_attempts": "Pause"
      },
      "workflow_completion_retention": "<string>"
    }
  ],
  "uri": "<string>",
  "additional_headers": {},
  "info": [
    {
      "message": "<string>",
      "code": "<string>"
    }
  ],
  "metadata": {},
  "sdk_version": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.restate.dev/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
deployment
string
required

Deployment identifier

Response

Deployment details including services and configuration

Detailed information about Restate deployments

​
created_at
string
required
​
http_version
string
required

HTTP Version

HTTP Version used to invoke this service deployment.

​
id
string
required

Deployment ID

​
max_protocol_version
integer<int32>
required

Maximum Service Protocol version

During registration, the SDKs declare a range from minimum (included) to maximum (included) Service Protocol supported version.

​
min_protocol_version
integer<int32>
required

Minimum Service Protocol version

During registration, the SDKs declare a range from minimum (included) to maximum (included) Service Protocol supported version.

​
protocol_type
enum<string>
required

Protocol Type

Protocol type used to invoke this service deployment.

Available options:
RequestResponse,
BidiStream
​
services
object[]
required

Services

List of services exposed by this deployment.

​
uri
string<uri>
required

Deployment URI

URI used to invoke this service deployment.

​
additional_headers
object

Additional headers

Additional headers used to invoke this service deployment.

​
info
object[]

Info

List of configuration/deprecation information related to this deployment.

​
metadata
object

Metadata

Deployment metadata.

​
sdk_version
string | null

SDK version

SDK library and version declared during registration.