Skip to main content
ZStack
Recently Deleted/Recently Deleted

ListManagedAgentTasks

List saved task summaries within current agent.read scope grants. Registered tasks use Agent ownership; pre-registration Deploy tasks use Invitation ownership. Filter by Agent, type, state and creation time before stable pagination. Does not return raw logs, configuration or commands.

GET/api/v1/lifecycle/managed-agent/tasks

Operation ID

ListManagedAgentTasks

Since

1.3.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

Query Parameters

  • platformUuid
    String

    Filter tasks by platform UUID

  • regionUuid
    String

    Filter tasks by region UUID

  • agentId
    String

    Filter tasks by managed agent identifier

  • type
    String

    Filter tasks by operation type

  • state
    String

    Filter tasks by execution state

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • items
    List

    Collection of result items

    Example: (nested array)

    • taskId
      String

      Task id for this resource

      Example: value

    • agentId
      String

      Agent id for this resource

      Example: value

    • invitationId
      String

      Invitation id for this resource

      Example: value

    • bindingId
      String

      Binding id for this resource

      Example: value

    • type
      String

      Persisted Agent task kind: deploy, change_capabilities, enable_capability, update_capability, disable_capability, restart_runtime, upgrade, renew_certificate, or revoke_access.

      Example: value

    • state
      String

      State for this resource

      Example: value

    • createdAt
      String

      Created at for this resource

      Example: 2026-01-15T08:00:00Z

    • startedAt
      String

      Started at for this resource

      Example: 2026-01-15T08:00:00Z

    • completedAt
      String

      Completed at for this resource

      Example: 2026-01-15T08:00:00Z

  • nextCursor
    String

    Next cursor for this resource

    Example: value

  • hasMore
    Boolean

    Whether another page of authorized task summaries is available.

    Example: true