topic Re: Files: Upload a file: "options" property "ttl", & full document aside v3 in APIs & Integrations

Files: Upload a file: "options" property "ttl", & full document aside v3 changes

jeff00seattle — Fri, 09 Jun 2023 03:57:57 GMT

The required param "options" for "Upload a file", property "ttl" is not documented. What is the expected format for "ttl" values?

Files: Changes in v3

Where is the entire document for the Files endpoint other than what changes were made for v3?

Thank you

Re: Files: Upload a file: "options" property "ttl", & full document aside v3

skimura — Fri, 09 Jun 2023 07:47:07 GMT

@jeff00seattle

Hi.

>What is the expected format for "ttl" values?

Please check "options description" and "example".

https://developers.hubspot.com/docs/api/files/files#upload-a-file

{ ... "ttl": "P2W", // means 2 weeks, ex: "P2M" means 2 months ... }

If you're using the ttl field: The minimum period that must be set is 1 day. The maximum period that can be set is 1 year. After the set period, the file will be permanently deleted. After deletion, the file cannot be recovered or restored.

community's related post

https://community.hubspot.com/t5/APIs-Integrations/For-how-long-will-I-have-the-access-of-the-uploaded-file/m-p/468505/highlight/true#M45441

>Where is the entire document for the Files endpoint other than what changes were made for v3?

I think, it's after "Upload a file". And "Endpoints" tab.

https://developers.hubspot.com/docs/api/files/files#upload-a-file

I hope it will be helpful.

Thanks.

Re: Files: Upload a file: "options" property "ttl", & full document aside v3

jeff00seattle — Fri, 09 Jun 2023 12:09:44 GMT

@skimura

Thank you for your reply

For "TTL" values, on Wikipedia

ISO 8601 -- Durations