---
title: "Nustatyti mėnesio būseną / Set period status"
method: POST
path: "/api/agent/v1/tools/set_period_status"
---

# Nustatyti mėnesio būseną / Set period status

`POST /api/agent/v1/tools/set_period_status`

## Request

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

Record whether a period is open or already filed. Filed periods cannot be reopened.

## Request body

- object
  - `periodId` string, required
  - `status` 'open' | 'filed_external', required
  - `reference` string, required
  - `expectedRevision` integer, 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)