# HubSpot Files API

**Canonical:** https://apis.io/apis/hubspot/hubspot-files-files-api/  
**Provider:** HubSpot — https://apis.io/providers/hubspot/  
**Base URL:** https://api.hubapi.com  
**Documentation:** https://developers.hubspot.com/docs/api-reference/latest/files/guide

HubSpot Files API is one of 144 APIs that [HubSpot](https://apis.io/providers/hubspot/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 692 JSON Schema definitions. Tagged areas include Files. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, code examples, and 692 JSON Schemas.

HubSpot Files — 20 operation(s) from HubSpot's published OpenAPI.

## Operations (20)

| Method | Path | Summary |
|---|---|---|
| POST | `/files/2026-03/files` | Upload file |
| POST | `/files/2026-03/files/import-from-url/async` | Import file from URL |
| GET | `/files/2026-03/files/import-from-url/async/tasks/{taskId}/status` | Check import status |
| GET | `/files/2026-03/files/search` | Search files |
| GET | `/files/2026-03/files/stat/{path}` | Retrieve file by path |
| GET | `/files/2026-03/files/{fileId}` | Retrieve file by ID |
| PUT | `/files/2026-03/files/{fileId}` | Replace file |
| DELETE | `/files/2026-03/files/{fileId}` | Delete file by ID |
| PATCH | `/files/2026-03/files/{fileId}` | Update file properties |
| DELETE | `/files/2026-03/files/{fileId}/gdpr-delete` | GDPR-delete file |
| GET | `/files/2026-03/files/{fileId}/signed-url` | Get signed URL to access private file |
| POST | `/files/2026-03/folders` | Create folder |
| GET | `/files/2026-03/folders/search` | Search folders |
| POST | `/files/2026-03/folders/update/async` | Update folder properties |
| GET | `/files/2026-03/folders/update/async/tasks/{taskId}/status` | Check folder update status |
| GET | `/files/2026-03/folders/{folderId}` | Retrieve folder by ID |
| DELETE | `/files/2026-03/folders/{folderId}` | Delete folder by ID |
| PATCH | `/files/2026-03/folders/{folderId}` | Update folder properties by folder ID |
| GET | `/files/2026-03/folders/{folderPath}` | Retrieve folder by path |
| DELETE | `/files/2026-03/folders/{folderPath}` | Delete folder by path |

## Machine-readable artifacts (1066)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/openapi/hubspot-files-files-api-openapi.yml
- **Documentation** — https://developers.hubspot.com/docs/api/cms/domains
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/domains-api-domain-collection-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/domains-api-domain-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/domains-api-forward-paging-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/domains-api-next-page-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/domains-api-domain-collection-response-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/domains-api-domain-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/domains-api-forward-paging-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/domains-api-next-page-structure.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/domains-api-domain-collection-response-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/domains-api-domain-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/domains-api-forward-paging-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/domains-api-next-page-example.json
- **GraphQL** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/graphql/hubspot-graphql.md
- **Documentation** — https://developers.hubspot.com/docs/api/cms/source-code
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-action-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-asset-file-metadata-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-file-extract-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-file-upload-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-task-locator-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-validation-error-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-validation-result-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-schema/source-code-api-validation-warning-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-action-response-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-asset-file-metadata-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-file-extract-request-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-file-upload-request-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-task-locator-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-validation-error-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-validation-result-structure.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/source-code-api-validation-warning-structure.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-action-response-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-asset-file-metadata-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-file-extract-request-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-file-upload-request-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-task-locator-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-validation-error-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-validation-result-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/examples/source-code-api-validation-warning-example.json
- …and 1026 more, listed in full on the page.

## Other HubSpot APIs (12)

- [HubSpot URL Redirects API](https://apis.io/apis/hubspot/hubspot-url-redirects-api/)
- [HubSpot Pipelines API](https://apis.io/apis/hubspot/hubspot-pipelines-api/)
- [HubSpot Products API](https://apis.io/apis/hubspot/hubspot-products-api/)
- [HubSpot Line Items API](https://apis.io/apis/hubspot/hubspot-line-items-api/)
- [HubSpot Quotes API](https://apis.io/apis/hubspot/hubspot-quotes-api/)
- [HubSpot CRM Properties API](https://apis.io/apis/hubspot/hubspot-crm-properties-api/)
- [HubSpot Owners API](https://apis.io/apis/hubspot/hubspot-owners-api/)
- [HubSpot CRM Imports API](https://apis.io/apis/hubspot/hubspot-crm-imports-api/)
- [HubSpot Custom Objects API](https://apis.io/apis/hubspot/hubspot-custom-objects-api/)
- [HubSpot Marketing Events API](https://apis.io/apis/hubspot/hubspot-marketing-events-api/)
- [HubSpot Forms API](https://apis.io/apis/hubspot/hubspot-forms-api/)
- [HubSpot Workflows API](https://apis.io/apis/hubspot/hubspot-workflows-api/)

## Tags

Files

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hubspot/hubspot-files-files-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hubspot/.