# FileDocumentDTO

> Response DTO for ``POST /files/`` and ``GET /files/{id}``.

Response DTO for \`\`POST /files/\`\` and \`\`GET /files/{id}\`\`.

# FileDocumentDTO

Response DTO for `POST /files/` and `GET /files/{id}`.

**id** string required

Opaque identifier for this file

**status** string required

Lifecycle status: awaiting\_upload | uploaded | active | infected

**display\_name** string

Human-readable label for the file

**content\_type** string

MIME type supplied by the client at create time

**upload\_url** string

S3 endpoint URL — POST your multipart form here to upload the file. Present only in the create response.

**upload\_fields** object

Required form fields to include in the multipart POST to S3 alongside the file binary

**url\_data** object

Nested DTO containing URLs for accessing an uploaded file.

**s3\_url** string

S3 URL where the file is accessible after upload

**preview\_url** string

CDN URL for previewing the uploaded file after upload completes

Source: https://developer.rippling.com/documentation/rest-api/reference/schemas/filedocumentdto

> For the complete documentation index, see [llms.txt](https://developer.rippling.com/llms.txt). Public pages have a Markdown version at the same URL with .md added.