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

[jeff00seattle]

Files: "Upload a file"

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

[skimura · Accepted solution]

@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-upload...

>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.

[jeff00seattle]

@skimura 

Thank you for your reply

For "TTL" values, on Wikipedia

ISO 8601 -- Durations