> ## Documentation Index > Fetch the complete documentation index at: https://getfloo.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Restart App > Restart an app by redeploying existing images with fresh env vars. Returns 202 immediately once the Deploy record is persisted. The actual Cloud Run redeploy runs out-of-band so the CLI's HTTP timeout never fires on a slow restart. ## OpenAPI ````yaml https://api.getfloo.com/openapi.json post /v1/apps/{app_id}/restart openapi: 3.1.0 info: title: floo API version: 0.1.0 servers: - url: https://api.getfloo.com security: [] paths: /v1/apps/{app_id}/restart: post: tags: - deploys summary: Restart App description: |- Restart an app by redeploying existing images with fresh env vars. Returns 202 immediately once the Deploy record is persisted. The actual Cloud Run redeploy runs out-of-band so the CLI's HTTP timeout never fires on a slow restart. operationId: deploys_restart_app parameters: - name: app_id in: path required: true schema: type: string format: uuid title: App Id - $ref: '#/components/parameters/X-Floo-Org-Id' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/RestartRequest' responses: '202': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/DeployResponse' default: description: Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - bearerAuth: [] components: parameters: X-Floo-Org-Id: name: X-Floo-Org-Id in: header required: false schema: type: string format: uuid description: Organization to act in; defaults to the one joined most recently. schemas: RestartRequest: properties: services: anyOf: - items: type: string type: array - type: 'null' title: Services type: object title: RestartRequest description: Request body for restarting an app. DeployResponse: properties: id: type: string format: uuid title: Id app_id: type: string format: uuid title: App Id service_id: anyOf: - type: string format: uuid - type: 'null' title: Service Id status: type: string title: Status runtime: type: string title: Runtime framework: anyOf: - type: string - type: 'null' title: Framework source_deploy_id: anyOf: - type: string format: uuid - type: 'null' title: Source Deploy Id build_logs: anyOf: - type: string - type: 'null' title: Build Logs url: anyOf: - type: string - type: 'null' title: Url cloud_run_service_name: anyOf: - type: string - type: 'null' title: Cloud Run Service Name commit_sha: anyOf: - type: string - type: 'null' title: Commit Sha coalesced_commits: items: $ref: '#/components/schemas/CoalescedCommitResponse' type: array title: Coalesced Commits github_ref: anyOf: - type: string - type: 'null' title: Github Ref triggered_by: type: string title: Triggered By env_id: anyOf: - type: string format: uuid - type: 'null' title: Env Id env: anyOf: - type: string - type: 'null' title: Env target_env: anyOf: - type: string - type: 'null' title: Target Env target_branch: anyOf: - type: string - type: 'null' title: Target Branch preview_slug: anyOf: - type: string - type: 'null' title: Preview Slug source_branch: anyOf: - type: string - type: 'null' title: Source Branch source_hash: anyOf: - type: string - type: 'null' title: Source Hash build_args_hash: anyOf: - type: string - type: 'null' title: Build Args Hash skip_reason: anyOf: - type: string - type: 'null' title: Skip Reason skip_migrations: type: boolean title: Skip Migrations default: false failure_category: anyOf: - type: string - type: 'null' title: Failure Category failure_message: anyOf: - type: string - type: 'null' title: Failure Message failure_step: anyOf: - type: string - type: 'null' title: Failure Step failure_root_cause: anyOf: - $ref: '#/components/schemas/FailureRootCauseResponse' - type: 'null' failure_reason: anyOf: - type: string - type: 'null' title: Failure Reason failure_stage: anyOf: - type: string - type: 'null' title: Failure Stage failing_stage: anyOf: - type: string - type: 'null' title: Failing Stage root_cause_event_excerpt: anyOf: - type: string - type: 'null' title: Root Cause Event Excerpt migrations: anyOf: - type: string - type: 'null' title: Migrations steps: items: $ref: '#/components/schemas/DeployStepResponse' type: array title: Steps default: [] diagnostics: items: $ref: '#/components/schemas/DeployDiagnosticResponse' type: array title: Diagnostics default: [] created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At started_at: anyOf: - type: string format: date-time - type: 'null' title: Started At finished_at: anyOf: - type: string format: date-time - type: 'null' title: Finished At duration_ms: anyOf: - type: integer - type: 'null' title: Duration Ms requested_app_access_mode: anyOf: - type: string - type: 'null' title: Requested App Access Mode requested_env_access_modes: anyOf: - additionalProperties: type: string type: object - type: 'null' title: Requested Env Access Modes type: object required: - id - app_id - status - runtime - framework - source_deploy_id - build_logs - url - triggered_by - created_at - updated_at title: DeployResponse description: Response for a single deploy. ErrorResponse: properties: detail: $ref: '#/components/schemas/ErrorDetail' type: object required: - detail title: ErrorResponse description: Body of every error response except request validation (422). CoalescedCommitResponse: properties: requested_commit_sha: type: string title: Requested Commit Sha source_repo_full_name: type: string title: Source Repo Full Name github_ref: type: string title: Github Ref created_at: type: string format: date-time title: Created At resolved_at: anyOf: - type: string format: date-time - type: 'null' title: Resolved At type: object required: - requested_commit_sha - source_repo_full_name - github_ref - created_at title: CoalescedCommitResponse description: A pushed commit whose effective outcome is this deploy. FailureRootCauseResponse: properties: stage: anyOf: - type: string - type: 'null' title: Stage reason: anyOf: - type: string - type: 'null' title: Reason details: $ref: '#/components/schemas/JsonObject-Output' first_failure_at: anyOf: - type: string format: date-time - type: 'null' title: First Failure At root_cause_event_excerpt: anyOf: - type: string - type: 'null' title: Root Cause Event Excerpt type: object title: FailureRootCauseResponse description: Normalized deploy failure summary for operator-facing surfaces. DeployStepResponse: properties: name: type: string title: Name status: type: string title: Status order: type: integer title: Order started_at: anyOf: - type: string format: date-time - type: 'null' title: Started At finished_at: anyOf: - type: string format: date-time - type: 'null' title: Finished At duration_ms: anyOf: - type: integer - type: 'null' title: Duration Ms error_category: anyOf: - type: string - type: 'null' title: Error Category error_message: anyOf: - type: string - type: 'null' title: Error Message skip_reason: anyOf: - type: string - type: 'null' title: Skip Reason type: object required: - name - status - order title: DeployStepResponse description: Response for a single deploy pipeline step. DeployDiagnosticResponse: properties: id: type: string format: uuid title: Id step_name: anyOf: - type: string - type: 'null' title: Step Name service_name: anyOf: - type: string - type: 'null' title: Service Name code: type: string title: Code severity: type: string title: Severity source: type: string title: Source title: type: string title: Title message: type: string title: Message fix: type: string title: Fix knowledge_ref: anyOf: - type: string - type: 'null' title: Knowledge Ref evidence_json: anyOf: - $ref: '#/components/schemas/JsonObject-Output' - type: 'null' created_at: type: string format: date-time title: Created At type: object required: - id - code - severity - source - title - message - fix - created_at title: DeployDiagnosticResponse description: Response for one structured deploy diagnostic. ErrorDetail: properties: code: type: string title: Code message: type: string title: Message additionalProperties: true type: object required: - code - message title: ErrorDetail description: Standard error envelope with operation-specific JSON context. JsonObject-Output: additionalProperties: $ref: '#/components/schemas/JsonValue-Output' type: object JsonValue-Output: anyOf: - type: boolean - type: integer - type: number - type: string - items: $ref: '#/components/schemas/JsonValue-Output' type: array - additionalProperties: $ref: '#/components/schemas/JsonValue-Output' type: object - type: 'null' securitySchemes: bearerAuth: type: http scheme: bearer description: A `floo_` API key. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.