Question

If I have the need to use the file upload feature, do I just need to submit for the role of file upload or also include the roles to perform tokenize and/or
detokenize operations?
Submit roles for file upload and tokenize and/or detokenize operations
Submit role for file upload only

Answer 1

If you only ever need to upload files (store or serve them) then request the file-upload role only. If you also plan to call the tokenize and/or detokenize endpoints on those files (e.g., to split/chunk, count tokens, prepare for embeddings or model input, or reassemble text), you must request those roles as well — tokenization/detokenization are separate permissions.

Recommendation: ask for the minimal set of roles you will actually use. If you expect to do any processing that requires tokenization/detokenization, submit roles for file upload plus tokenize and/or detokenize. If not, submit file upload only.