Workspaces
A workspace is one company in Shypr. It has its own customers, products, invoices, stock and settings. All data you read or write through the API belongs to one workspace.
An API key works in its own workspace
Section titled “An API key works in its own workspace”An API key belongs to the workspace in which you made it. Each request with that key reads and writes only the data of that workspace. You do not send a workspace id.
A key cannot switch to another workspace. If your integration serves more workspaces, make one key in each workspace.
Each record has a uid: a UUID v7, for example 01936f6e-2b1c-7a4e-9c1d-3f5e8a2b7c90. A UUID v7 starts with its creation time, so the ids sort by age.
In GraphQL, the id field is the IRI of the record, for example /invoices/01936f6e-2b1c-7a4e-9c1d-3f5e8a2b7c90. Use the IRI as the id argument of a single-record query:
{ invoice(id: "/invoices/01936f6e-2b1c-7a4e-9c1d-3f5e8a2b7c90") { uid displaySequenceId }}Time zone
Section titled “Time zone”Each workspace has a time zone. Dates in the API are unix times, so they do not depend on a time zone. See Data types.