Create File¶

POST /rest/asset/v1/files.json

Permissions Read-Write Assets

Build a request and mock the response

Method: POST
Path: /rest/asset/v1/files.json
Tag: Files
Operation ID: createFileUsingPOST

Creates a new file from the included payload. Required Permissions: Read-Write Assets

Formats¶

Request: multipart/form-data
Response: application/json

Request¶

Request body¶

Name: createFileRequest
Required: Yes
Schema: model: CreateFileRequest

createFileRequest

Generated example¶

{
  "description": "string",
  "file": "string",
  "folder": {
    "id": 123,
    "type": "Folder"
  },
  "insertOnly": true,
  "name": "Example name"
}

Referenced models¶

CreateFileRequest

Example request¶

POST {{base_url}}/rest/asset/v1/files.json
Content-Type: multipart/form-data
Accept: application/json

{
  "description": "string",
  "file": "string",
  "folder": {
    "id": 123,
    "type": "Folder"
  },
  "insertOnly": true,
  "name": "Example name"
}

Responses¶

200 — OK¶

Schema: model: ResponseOfFileResponse

Generated example¶

{
  "errors": [
    {
      "code": "string",
      "message": "string"
    }
  ],
  "requestId": "123",
  "result": [
    {
      "createdAt": "2026-01-15T10:30:00Z",
      "description": "string",
      "folder": {
        "id": 123,
        "name": "Example name",
        "type": "string"
      },
      "id": 123,
      "mimeType": "string",
      "name": "Example name",
      "size": 123,
      "updatedAt": "2026-01-15T10:30:00Z",
      "url": "https://example.com"
    }
  ],
  "success": true,
  "warnings": [
    "string"
  ]
}

Referenced models¶

ResponseOfFileResponse

Source¶

Generated from swagger-asset.json.

Generated examples are inferred from the schema. They are illustrative and may not be valid production payloads.