> ## Documentation Index > Fetch the complete documentation index at: https://docs.tracecat.com/llms.txt > Use this file to discover all available pages before exploring further. # List Rollouts > List rollout records, newest first. ## OpenAPI ````yaml https://platform.tracecat.com/api/openapi.json get /admin/managed-resources/rollouts openapi: 3.1.0 info: title: Tracecat API summary: Tracecat API description: The open source AI automation platform for security teams and agents. termsOfService: >- https://docs.google.com/document/d/e/2PACX-1vQvDe3SoVAPoQc51MgfGCP71IqFYX_rMVEde8zC4qmBCec5f8PLKQRdxa6tsUABT8gWAR9J-EVs2CrQ/pub contact: name: Tracecat Founders email: founders@tracecat.com license: name: AGPL-3.0 url: https://www.gnu.org/licenses/agpl-3.0.html version: '1' servers: - url: /api security: [] tags: - name: public description: Public facing endpoints - name: workflows description: Workflow management - name: actions description: Action management - name: triggers description: Workflow triggers - name: secrets description: Secret management - name: variables description: Workspace variable management paths: /admin/managed-resources/rollouts: get: tags: - admin - admin:managed-resources summary: List Rollouts description: List rollout records, newest first. operationId: admin-list_rollouts parameters: - name: target_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' title: Target Id - name: limit in: query required: false schema: type: integer maximum: 200 minimum: 1 default: 20 title: Limit - name: cursor in: query required: false schema: anyOf: - type: string maxLength: 8192 - type: 'null' title: Cursor responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/Page_ManagedRolloutRead_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyCookie: [] components: schemas: Page_ManagedRolloutRead_: properties: items: items: $ref: '#/components/schemas/ManagedRolloutRead' type: array title: Items next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor description: Next-page cursor prev_cursor: anyOf: - type: string - type: 'null' title: Prev Cursor description: Previous-page cursor type: object required: - items title: Page[ManagedRolloutRead] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ManagedRolloutRead: properties: id: type: string format: uuid title: Id target_id: anyOf: - type: string format: uuid - type: 'null' title: Target Id workspace_id: type: string format: uuid title: Workspace Id kind: $ref: '#/components/schemas/ManagedRolloutKind' status: $ref: '#/components/schemas/ManagedRolloutStatus' tag: anyOf: - type: string - type: 'null' title: Tag commit_sha: anyOf: - type: string - type: 'null' title: Commit Sha preview: anyOf: - $ref: '#/components/schemas/RolloutPreview' - type: 'null' error: anyOf: - type: string - type: 'null' title: Error created_at: type: string format: date-time title: Created At applied_at: anyOf: - type: string format: date-time - type: 'null' title: Applied At type: object required: - id - target_id - workspace_id - kind - status - tag - commit_sha - preview - error - created_at - applied_at title: ManagedRolloutRead description: One rollout record for one target. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ManagedRolloutKind: type: string enum: - apply - unassign title: ManagedRolloutKind description: What a rollout record does to its target workspace. ManagedRolloutStatus: type: string enum: - previewing - ready - no_changes - blocked - needs_references - applying - applied - failed - stale title: ManagedRolloutStatus description: Lifecycle of one rollout record for one target workspace. RolloutPreview: properties: changes: items: $ref: '#/components/schemas/RolloutChange' type: array title: Changes conflicts: items: $ref: '#/components/schemas/RolloutConflict' type: array title: Conflicts references: items: $ref: '#/components/schemas/RolloutReference' type: array title: References delete_warnings: items: $ref: '#/components/schemas/RolloutDeleteWarning' type: array title: Delete Warnings registry: items: $ref: '#/components/schemas/RolloutRegistryPlan' type: array title: Registry dropped_customer_skills: items: $ref: '#/components/schemas/RolloutDroppedSkill' type: array title: Dropped Customer Skills diagnostics: items: type: string type: array title: Diagnostics type: object title: RolloutPreview description: Everything an FDE reviews before applying a tag to one target. RolloutChange: properties: change: $ref: '#/components/schemas/RolloutChangeKind' resource_type: $ref: '#/components/schemas/SyncResourceType' source_id: type: string title: Source Id name: type: string title: Name type: object required: - change - resource_type - source_id - name title: RolloutChange description: One resource a rollout adds, modifies or deletes in the target. RolloutConflict: properties: resource_type: $ref: '#/components/schemas/SyncResourceType' source_id: type: string title: Source Id name: type: string title: Name description: The name both resources share. existing_local_id: type: string format: uuid title: Existing Local Id description: The customer's resource. type: object required: - resource_type - source_id - name - existing_local_id title: RolloutConflict description: >- An incoming managed resource whose name a customer resource already uses. RolloutReference: properties: kind: $ref: '#/components/schemas/ManagedReferenceKind' source_key: type: string title: Source Key description: Source catalog id, integration id or store. label: type: string title: Label description: What the source calls it. type: object required: - kind - source_key - label title: RolloutReference description: A model, MCP integration or secret store the target must match. RolloutDeleteWarning: properties: resource_type: $ref: '#/components/schemas/SyncResourceType' source_id: type: string title: Source Id name: type: string title: Name table_rows: anyOf: - type: integer - type: 'null' title: Table Rows description: Rows in a deleted table. cases_using: anyOf: - type: integer - type: 'null' title: Cases Using description: >- Cases using a deleted case tag or dropdown. For a deleted case field, the number of cases in the workspace whose value is erased. has_customer_values: type: boolean title: Has Customer Values description: A deleted secret or variable holds values. default: false referenced_by: items: type: string type: array title: Referenced By description: Customer workflows and presets that mention it by name. type: object required: - resource_type - source_id - name title: RolloutDeleteWarning description: Customer data a delete destroys, shown before the FDE applies. RolloutRegistryPlan: properties: origin: type: string title: Origin version: type: string title: Version action: $ref: '#/components/schemas/RegistryInstallAction' reason: anyOf: - type: string - type: 'null' title: Reason type: object required: - origin - version - action title: RolloutRegistryPlan description: What a rollout does with one custom registry repository. RolloutDroppedSkill: properties: preset: type: string title: Preset skill: type: string title: Skill type: object required: - preset - skill title: RolloutDroppedSkill description: A customer skill binding dropped because the package now binds it. RolloutChangeKind: type: string enum: - added - modified - deleted SyncResourceType: type: string enum: - workflow - agent_preset - skill - table - case_tag - case_field - case_dropdown - case_duration - variable - secret_metadata title: SyncResourceType description: |- Kind of workspace resource that can be synced to and from Git. Every member is adapter-backed: it can be projected to and imported from repository files. ManagedReferenceKind: type: string enum: - model - mcp_integration - secret_store title: ManagedReferenceKind description: Kind of source-side reference a target workspace must resolve locally. RegistryInstallAction: type: string enum: - install - present - blocked securitySchemes: APIKeyCookie: type: apiKey in: cookie name: fastapiusersauth ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.