---
title: "Insere ou atualiza um arquivo no local especificado pelo nome e pasta do mesmo."
method: POST
path: "/api/v1/Storage"
tags: ["Storage"]
---

# Insere ou atualiza um arquivo no local especificado pelo nome e pasta do mesmo.

`POST /api/v1/Storage`

## Request

- Base URL: `https://api.meucartaosim.com.br` (the document declares no server; this is the origin it was published from)
- URL: `https://api.meucartaosim.com.br/api/v1/Storage`
- Auth: API key in header `Authorization`

## Request body

- PutStorageDTO
  - `fileName` string, required
  - `folder` string, required
  - `file` string, required

## Response `200`

OK

- StringCustomReturn
  - `data` string[], nullable
  - `total` integer
  - `responseTime` integer
  - `feedback` string, nullable
  - `status` 'Continue' | 'SwitchingProtocols' | 'Processing' | 'EarlyHints' | 'OK' | 'Created' | 'Accepted' | 'NonAuthoritativeInformation' | 'NoContent' | 'ResetContent' | 'PartialContent' | 'MultiStatus' | 'AlreadyReported' | 'IMUsed' | 'MultipleChoices' | 'MovedPermanently' | 'Found' | 'SeeOther' | 'NotModified' | 'UseProxy' | 'Unused' | 'TemporaryRedirect' | 'PermanentRedirect' | 'BadRequest' | 'Unauthorized' | 'PaymentRequired' | 'Forbidden' | 'NotFound' | 'MethodNotAllowed' | 'NotAcceptable' | 'ProxyAuthenticationRequired' | 'RequestTimeout' | 'Conflict' | 'Gone' | 'LengthRequired' | 'PreconditionFailed' | 'RequestEntityTooLarge' | 'RequestUriTooLong' | 'UnsupportedMediaType' | 'RequestedRangeNotSatisfiable' | 'ExpectationFailed' | 'MisdirectedRequest' | 'UnprocessableEntity' | 'Locked' | 'FailedDependency' | 'UpgradeRequired' | 'PreconditionRequired' | 'TooManyRequests' | 'RequestHeaderFieldsTooLarge' | 'UnavailableForLegalReasons' | 'InternalServerError' | 'NotImplemented' | 'BadGateway' | 'ServiceUnavailable' | 'GatewayTimeout' | 'HttpVersionNotSupported' | 'VariantAlsoNegotiates' | 'InsufficientStorage' | 'LoopDetected' | 'NotExtended' | 'NetworkAuthenticationRequired'
  - `notifications` ReturnError[], nullable
    - `type` string, nullable
    - `message` string, nullable
    - `code` string, nullable
  - `warnings` ReturnError[], nullable
    - `type` string, nullable
    - `message` string, nullable
    - `code` string, nullable

## Other responses

- `400`: Bad Request

## Changes

- **2026-11-07** `d17228159154`: 9 breaking
  - the `file` request property's minLength was increased from `0` to `1` (media type: application/json)
  - the `file` request property's minLength was increased from `0` to `1` (media type: text/json)
  - the `file` request property's minLength was increased from `0` to `1` (media type: application/*+json)
  - the `fileName` request property's minLength was increased from `0` to `1` (media type: application/json)
  - …5 more

[Operation history](https://skmtc.dev/meucartaosim/apis/cartaosim-api/changes/api/v1/Storage/post.md)

---

[API](https://skmtc.dev/meucartaosim/apis/cartaosim-api.md) - [All operations](https://skmtc.dev/meucartaosim/apis/cartaosim-api/llms.txt) - [OpenAPI document](https://skmtc.dev/meucartaosim/apis/cartaosim-api/revisions/d17228159154?raw)
