Skip to navigation

Update a company

View as Markdown

Changes the given attributes; omitted ones stay. VAT and employee dates decide which monthly work applies. Use dryRun=true to preview.

Authentication

AuthorizationBearer

Skaitra API key (skt_…).

OR
AuthorizationBearer

OAuth 2.1 access token issued for the Skaitra resource (/mcp); see /.well-known/oauth-protected-resource.

Path parameters

idstringRequired1-200 characters

Headers

Idempotency-KeystringOptional<=200 characters

Any unique value; a retry with the same key returns the first result.

Query parameters

dryRunboolean or enumOptional

true validates and returns the changes without saving them.

Request

This endpoint expects an object.
shortNamestring or nullOptional<=300 characters
legalFormstring or nullOptional<=300 characters
addressstring or nullOptional<=300 characters
directorNamestring or nullOptional<=300 characters
vatPeriodenum or nullOptional
Allowed values:
vatFromdate or nullOptional
vatTodate or nullOptional
employeesFromdate or nullOptional
employeesTodate or nullOptional
serviceStoppedFromdate or nullOptional
serviceStoppedReasonstring or nullOptional<=200 characters

Response

OK
Companyobject
OR
object

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
412
Precondition Failed Error
422
Unprocessable Entity Error
428
Precondition Error