---
title: "Get agent details"
method: GET
path: "/agents/{agentName}"
---

# Get agent details

`GET /agents/{agentName}`

## Path parameters

- `agentName` string, required

## Response `200`

Agent details retrieved successfully

- ServiceDetailsResponse
  - `name` string — Name of the agent
  - `region` string — The region where the agent is deployed
  - `ready` boolean — Whether the latest deployment has passed validation and is ready. For scale-to-zero agents, this is true even when scaled down to zero replicas.
  - `available` boolean — Whether the agent can accept new sessions. True when any pods are ready to handle traffic, or when scaled to zero but healthy (requests will queue and trigger scale-up). During rolling updates, this may be true even if `ready` is false, as old pods continue serving while new ones validate.
  - `createdAt` string, date-time — Creation timestamp of the agent
  - `updatedAt` string, date-time — Last update timestamp
  - `desiredDeploymentId` string — ID of the deployment that was requested. Use this to track which deployment should be running.
  - `activeDeploymentId` string — **Deprecated**: Use `desiredDeploymentId` instead. ID of the requested deployment.
  - `reconciledDeploymentId` string — ID of the deployment that the operator has actually reconciled. Compare with `desiredDeploymentId` to determine if a deployment update has been processed. When these match and `ready` is true, the deployment is fully complete.
  - `activeDeploymentReady` boolean — **Deprecated**: Use `ready` instead. Whether the active deployment is ready. This field is redundant with `ready` and will be removed in a future version.
  - `autoScaling` object
    - `maxReplicas` integer — Maximum number of agent replicas
    - `minReplicas` integer — Minimum number of agent replicas
  - `activeSessionCount` integer — Number of active sessions
  - `deployment` object, nullable — Details of the current deployment
    - `id` string — Unique identifier for the deployment
    - `manifest` object — Kubernetes manifest for the deployment
      - `apiVersion` string — API version of the manifest
      - `kind` string — Kind of Kubernetes resource
      - `metadata` object — Metadata for the resource
        - `name` string — Name of the agent
        - `namespace` string — Kubernetes namespace
      - `spec` object — Specification for the agent deployment
        - `dailyNodeType` string — Type of node to run on
        - `image` string — Container image used. Redacted when deployed via a build.
        - `autoScaling` object — Auto-scaling configuration
          - `minReplicas` integer — Minimum number of replicas
          - `maxReplicas` integer — Maximum number of replicas
        - `imagePullSecretName` string — Name of the image pull secret used
        - `envFromSecretNames` string[] — Names of secrets to use as environment variables
        - `resources` object — Resource allocation for the agent
          - `cpu` string — CPU allocation
          - `memory` string — Memory allocation
        - `krispViva` object — Krisp VIVA configuration
          - `audioFilters` boolean — Whether Krisp VIVA audio filters are enabled
        - `maxSessionDurationSeconds` integer — Maximum session duration in seconds configured for this service. Absent when the service is using the platform default.
    - `serviceId` string — ID of the service this deployment belongs to
    - `createdAt` string, date-time — Creation timestamp of the deployment
    - `updatedAt` string, date-time — Last update timestamp of the deployment
  - `agentProfile` string, nullable — The agent profile used for resource allocation
  - `krispViva` object, nullable — Krisp VIVA status
    - `audioFilter` string, nullable — The currently configured Krisp VIVA audio filter model (tel, pro, or null if disabled)
  - `currentRevision` RevisionInfo
    - `deploymentID` string — ID of the deployment for this revision
    - `phase` 'Creating' | 'Validating' | 'Active' | 'Draining' | 'Failed' — Current phase of the revision
    - `readyReplicas` integer — Number of ready replicas for this revision
    - `phaseStartedAt` string, date-time — Timestamp when the current phase started
    - `health` RevisionHealth — Health summary for the agent's code. Present once replicas have started running.
      - `ready` boolean — Whether the agent code is passing readiness checks
      - `state` 'running' | 'waiting' | 'terminated' — Current state of the agent code
      - `restartCount` integer — Total number of restarts across all replicas
      - `replicasStarted` integer — Number of replicas that have been started (may or may not be ready)
      - `reason` string — Reason for the current state (e.g., CrashLoopBackOff, ImagePullBackOff, OOMKilled, Error)
      - `lastExitCode` integer — Exit code from the most recent crash (e.g., 1 for application error, 137 for out-of-memory)
      - `lastTerminationReason` string — Why the agent code last exited. When reason is CrashLoopBackOff, this reveals the underlying cause (e.g., OOMKilled, Error)
      - `message` string — Detailed error output from the crash, such as a Python traceback. Captured from the agent's stderr/stdout on non-zero exit.
    - `hasInfrastructureIssue` boolean — Set to true when an internal infrastructure component is experiencing issues. If absent, infrastructure is healthy. Contact support if this flag appears.
  - `previousRevision` RevisionInfo
    - `deploymentID` string — ID of the deployment for this revision
    - `phase` 'Creating' | 'Validating' | 'Active' | 'Draining' | 'Failed' — Current phase of the revision
    - `readyReplicas` integer — Number of ready replicas for this revision
    - `phaseStartedAt` string, date-time — Timestamp when the current phase started
    - `health` RevisionHealth — Health summary for the agent's code. Present once replicas have started running.
      - `ready` boolean — Whether the agent code is passing readiness checks
      - `state` 'running' | 'waiting' | 'terminated' — Current state of the agent code
      - `restartCount` integer — Total number of restarts across all replicas
      - `replicasStarted` integer — Number of replicas that have been started (may or may not be ready)
      - `reason` string — Reason for the current state (e.g., CrashLoopBackOff, ImagePullBackOff, OOMKilled, Error)
      - `lastExitCode` integer — Exit code from the most recent crash (e.g., 1 for application error, 137 for out-of-memory)
      - `lastTerminationReason` string — Why the agent code last exited. When reason is CrashLoopBackOff, this reveals the underlying cause (e.g., OOMKilled, Error)
      - `message` string — Detailed error output from the crash, such as a Python traceback. Captured from the agent's stderr/stdout on non-zero exit.
    - `hasInfrastructureIssue` boolean — Set to true when an internal infrastructure component is experiencing issues. If absent, infrastructure is healthy. Contact support if this flag appears.

## Other responses

- `404` — Agent not found
- `500` — Internal server error

---

[API](https://skmtc.dev/pipecat/apis/pipecat-cloud.md) · [All operations](https://skmtc.dev/pipecat/apis/pipecat-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pipecat/pipecat-cloud/revisions/acd0f7dfe734/schema)