> ## Documentation Index
> Fetch the complete documentation index at: https://docs.strangelooplabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Automation File

> Creating a file in Strange Loop that can be used as input to an Automation

This endpoint tells Strange Loop the details of a file you wish to pass as input to an Automation.
Its response will tell the caller where they can upload the file to make it accessible
to the Strange Loop platform.

```
PUT https://api.strangelooplabs.ai/automations/files
```

### Request

<ParamField body="file_name" type="string">
  The name of the file, including extension.
</ParamField>

<ParamField body="file_size" type="integer">
  The size of the file, in bytes.
</ParamField>

### Response

<ResponseField name="file_id" type="string">
  A unique identifier for the file.
  You will pass the ID to a subsequent call to invoke the Automation.
</ResponseField>

<ResponseField name="url" type="string">
  The URL to which the file should be uploaded in the next step.
</ResponseField>

<ResponseField name="fields" type="object">
  A key-value map of parameters which need to be passed when the file is uploaded,
  in order to authenticate the call.
</ResponseField>

<ResponseField name="extension" type="string">
  The identified extension of the file.
</ResponseField>

<RequestExample>
  ```bash Example Request theme={null}
  curl -X PUT -d '{"file_name": "test.pdf", "file_size": 1024}' -H "Content-Type: application/json" https://api.strangelooplabs.ai/automations/files
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
      "file_id": "123456789",
      "url": "https://strangeloop-automations-documents.s3.amazonaws.com/",
      "fields": {
          "AWSAccessKeyId": "access-key-value",
          "key": "123456789.pdf",
          "policy": "policy-value",
          "signature": "signature-value",
          "x-amz-security-token": "security-token-value"
      },
      "extension": "pdf"
  }
  ```
</ResponseExample>