---
title: "Prašyti įkelti dokumentus / Request document upload"
method: POST
path: "/api/agent/v1/tools/request_document_upload"
---

# Prašyti įkelti dokumentus / Request document upload

`POST /api/agent/v1/tools/request_document_upload`

## Request

- Base URL: `https://app.taxmeter.lt`
- URL: `https://app.taxmeter.lt/api/agent/v1/tools/request_document_upload`
- Auth: OAuth 2 (authorization code, authorization URL `https://app.taxmeter.lt/oauth/authorize`, token URL `https://app.taxmeter.lt/oauth/token`, scopes: `prepare`)

Ask the grantor to select PDF/JPEG/PNG files in their browser for a permitted month. Poll get_request for accumulated document IDs, then read_source. The link requires the signed-in grantor; file selection does not review or approve facts.

## Request body

- object
  - `periodId` string, required
  - `reason` string, required

## Response `200`

Įrankio rezultatas / Tool result

- object

## Other responses

- `400`: Netinkami argumentai / Invalid arguments
- `401`: Reikalingas OAuth / OAuth required
- `403`: Prieiga nesuteikta / Permission or current legal acceptance required
- `404`: Nerasta / Tool or object not found
- `409`: Pasenusi versija / Stale revision or digest
- `413`: Per didelis turinys / Size limit
- `429`: Naudojimo riba / Quota or rate limit
- `503`: Priežiūra / Maintenance
- `507`: Trūksta vietos / Disk space low

---

[API](https://skmtc.dev/taxmeter/apis/taxmeter-agentu-http-api-taxmeter-agent-http-api.md) · [All operations](https://skmtc.dev/taxmeter/apis/taxmeter-agentu-http-api-taxmeter-agent-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/taxmeter/apis/taxmeter-agentu-http-api-taxmeter-agent-http-api/revisions/f61468f014c7?raw)