[API] Documentation for createAttachment is a bit confusing

[hwelch-fle]

EDIT: I've solved the issue. I was passing the wrong Content-Type headers (needed the uui boundary. Removing the header override fixed it:

resp = self.client.post("api/cards/{cardId}/attachments".format(**args), 
    data=kwargs, 
    files={'file': (name, file_data, mime_type)},  
  -- headers={'Content-Type': 'multipart/form-data'} # Removed this to allow the client to set the boudanry
)
raise_planka_err(resp)

Currently it seems that the createAttachment endpoint allows posting binary data to the file attribute of the request body, but I can't seem to get this to work. Does this endpoint require the keys in the form data as well as the request body?

Here's the error:

ValidationError: The server could not fulfill this request (`POST /api/cards/{cardId}/attachments`) due to 2 missing or invalid parameters.
"type" is required, but it was not defined.
"name" is required, but it was not defined.

And here's all the request data

Data/Keys:

{'type': 'file', 'name': 'image.png'}

Headers:

{
    'host': 'localhost:1337', 
    'accept': '*/*', 
    'accept-encoding': 'gzip, deflate, br', 
    'connection': 'keep-alive', 
    'user-agent': 'python-httpx/0.28.1', 
    'authorization': '[secure]', 
    'content-type': 'multipart/form-data', 
    'cookie': 'httpOnlyToken=[token]', 
    'content-length': '52395'
}

Form Data:

b'--9cce012f401e11efd7629ae568a9807c
Content-Disposition: form-data; name="type"

file <<-'type' is passed as 'file' to form-data
--9cce012f401e11efd7629ae568a9807c
Content-Disposition: form-data; name="name"

image.png <<-'name' is passed as 'image.png' to form-data
--9cce012f401e11efd7629ae568a9807c
Content-Disposition: form-data; name="image.png"; filename="upload"
Content-Type: application/octet-stream

\x89PNG [..snip]
--9cce012f401e11efd7629ae568a9807c--
'