> ## Documentation Index > Fetch the complete documentation index at: https://www.ravion.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Get an upload of a deploy's files > Read an upload as the app's sandbox reports it: waiting for its files or unpacking them, unpacked, or failed. GET /apps/{id}/uploads/{uploadId} in the… ## OpenAPI ````yaml https://api.ravion.com/openapi.yaml get /apps/{id}/uploads/{uploadId} openapi: 3.0.0 info: title: Ravion version: 0.0.0 servers: - url: https://api.ravion.com security: - BearerAuth: [] tags: - name: Projects - name: Environments - name: FeatureFlags - name: Pipelines - name: PipelineRuns - name: TerraformResources - name: TerraformExecutionSummaries - name: PipelineStepExecutions - name: AwsCloudWatch - name: AwsAmp - name: PipelineVersions - name: Organizations - name: Stacks - name: StackWorkspaces - name: Auth - name: OAuth - name: User - name: Health - name: Memberships - name: ServiceAccounts - name: Integrations - name: AwsDefaultNetworks - name: AwsAccounts - name: ApiKeys - name: EksPrometheus - name: EksLoki - name: ExecutionEnvironments - name: ModuleDefinitions - name: ModuleCategories - name: ModuleVersions - name: ModuleInstances - name: DefaultValueDefinitions - name: DefaultValues - name: CodeSources - name: Github - name: GitHub Actions - name: Alerts - name: Gitlab - name: Slack - name: Git - name: MergeQueues - name: Values - name: Deployments - name: DeploymentResources - name: InfrastructureEvents - name: WebSocket - name: Domains - name: AcmCertificates - name: NotificationDestinations - name: NotificationDispatches - name: NotificationEvents - name: NotificationRules - name: Activity - name: Describe - name: Reports - name: BillingPlans - name: BillingAccounts - name: BillingCycles - name: BillingUsageSummaries - name: BillingAddOns - name: BillingInvoices - name: Authorization - name: Sandboxes - name: SandboxCommands - name: SandboxPorts - name: Apps paths: /apps/{id}/uploads/{uploadId}: get: tags: - Apps summary: Get an upload of a deploy's files description: >- Read an upload as the app's sandbox reports it: waiting for its files or unpacking them, unpacked, or failed. Returns 404 `UPLOAD_NOT_FOUND` when the sandbox holds no record of the upload, as after the sandbox started again, and 409 when the app's sandbox is not `RUNNING`. operationId: GetAppUpload parameters: - in: path name: id required: true schema: type: string - description: The upload's id, as opening it answered. in: path name: uploadId required: true schema: pattern: ^[a-z0-9][a-z0-9-]{0,63}$ type: string responses: '200': content: application/json: schema: additionalProperties: false properties: data: $ref: '#/components/schemas/AppUploadStatus' required: - data type: object description: The request has succeeded. '400': content: application/json: schema: $ref: '#/components/schemas/Errors.UserFacingErrorData' description: The request is invalid or malformed. '401': content: application/json: schema: $ref: '#/components/schemas/Errors.UserFacingErrorData' description: You are not authenticated '403': content: application/json: schema: $ref: '#/components/schemas/Errors.UserFacingErrorData' description: You do not have permission to access this resource. '404': content: application/json: schema: $ref: '#/components/schemas/Errors.UserFacingErrorData' description: The server cannot find the requested resource. '409': content: application/json: schema: $ref: '#/components/schemas/Errors.UserFacingErrorData' description: The request conflicts with the current state of the server. '500': content: application/json: schema: $ref: '#/components/schemas/Errors.UserFacingErrorData' description: Server error components: schemas: AppUploadStatus: additionalProperties: false description: An upload, as the app's sandbox reports it. properties: exitCode: description: >- Exit code of the unpacking, once it has exited on its own. Zero means every file was written. format: int32 type: integer signal: description: >- Signal that ended the unpacking, such as `KILL` when the files did not arrive whole or the upload expired before they were sent. type: string state: allOf: - $ref: '#/components/schemas/AppUploadState' description: Where the upload is. uploadId: description: The upload's id. type: string required: - uploadId - state type: object Errors.UserFacingErrorData: additionalProperties: false description: |- User-facing error presentation data. This is what the API returns to the frontend after formatting ErrorData using CEL templates from the error registry. Used for both: - Error fields on domain models (e.g., PipelineRun.error) - API error response bodies (HTTP 4xx/5xx responses) properties: action: allOf: - $ref: '#/components/schemas/Errors.Action' description: Optional action to help resolve the error code: description: Full error code, e.g., "Ravion:Pipeline:NOT_FOUND" type: string description: description: Additional description with more details type: string details: description: Structured details rendered as user-facing sections. items: $ref: '#/components/schemas/Errors.UserFacingErrorDetailSection' type: array isInternal: description: >- Indicates whether this error is internal (only set when ShowInternal=true). This allows SUPERADMINs to identify internal errors while viewing full details. type: boolean message: description: Main error message (required) type: string metadata: additionalProperties: {} description: >- Error params/metadata. Stripped for internal errors unless superadmin. type: object requestId: description: Request ID for correlating errors with server logs. type: string required: - code - message type: object AppUploadState: description: >- Where an upload is. `RECEIVING`: the app's sandbox is waiting for the files, or still unpacking them. `SUCCEEDED`: the files were unpacked, and a deploy may name the upload. `FAILED`: the files were not unpacked, because unpacking them failed, they did not arrive whole or were not the archive the upload was opened for, the upload expired before they were sent, or another upload of the sandbox was opened. enum: - RECEIVING - SUCCEEDED - FAILED type: string Errors.Action: additionalProperties: false description: Action to help user resolve the error properties: label: description: Button/link label text type: string url: description: URL to navigate to for resolution type: string required: - label - url type: object Errors.UserFacingErrorDetailSection: additionalProperties: false description: Structured user-facing error detail section. properties: items: description: List of detail values for this section. items: type: string type: array object: additionalProperties: {} description: Structured detail payload for object rendering. type: object render: description: Rendering hint for clients. Valid values are list or object. type: string title: description: Detail section title shown in the UI. type: string required: - title - render type: object securitySchemes: BearerAuth: scheme: Bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.