PUT
/
silo
/
v1
/
entries
/
{id}

Use UUID versions 1 or 7 for documents with a specific lifespan like invoices or payment receipts, or versions 3, 4, and 5 for long-lived data like contacts or products. The rules for UUID versions are enforced by specific folder configurations.

The data field may contain either a GOBL Envelope or Object, and will be validated before being persisted.

New entries may also be created based on a previous entry using the previous_id field. Using a previous entry allows you to provide patch data instead of a new full document by setting the patch type in the content_type field to either:

  • application/json-patch+json - for JSON Patch (RFC 6902)
  • application/merge-patch+json - for JSON Merge Patch (RFC 7396)

The previous_id field can also be used to make corrective documents by adding the corrective option data in the correct field. For more details on this, see the GOBL documentation for correction options.

Path Parameters

id
string
required

UUID of the silo entry to create.

Body

application/json
allow_invalid
boolean

When true, the envelope's contents are allowed to be invalid.

content_type
string

The content type of the data being uploaded.

correct
object

JSON object containing the GOBL correction option data.

data
object

Data contents to upload which may either be a GOBL Envelope or Object. Any partial data will be calculated and validated automatically.

folder
string

In which folder the entry should be associated, leave empty to use the automatic rules.

previous_id
string

The UUID of the previous silo entry to copy.

Response

200 - application/json
attachments
object[]

List of attachments for this entry.

context
string

When entry provided within a related query, this is the context within the document.

created_at
string

The date and time the silo entry was created.

data
object

JSON envelope contents when specifically requested.

digest
object
doc_schema
string

Schema URL for the envelope's payload.

draft
boolean

Deprectated. When true, indicates that the envelope is not signed.

env_schema
string

Schema URL for the envelope.

faults
object[]

List of faults that occurred during the processing of the job associated with the last state.

folder
string

Key for the folder where the entry is located.

id
string

UUID of the silo entry.

invalid
boolean

When true, the envelope's contents are invalid and need to be reviewed.

meta
object[]

Additional meta fields associated with the entry.

signed
boolean

When true, the envelope has been signed and should not be modified.

snippet
object

JSON object containing a snippet of the document.

state
string

Current state of the silo entry if not a draft.

tags
string[]

Copy of tags stored in the envelope header.

updated_at
string

The date and time the silo entry was last updated.