Home /  API Reference / 

Stash

Stash API specification.

For more information, read the Getting Started Guide.

All API endpoints are POST operations and any parameters must be fully contained in the request body.

Download OpenAPI

Create Keyspace

POST/CreateKeyspace
Create a new Keyspace. Keyspace names are unique to a Stedi account.
Request body

application/json

keyspaceNameRequiredstring
The name that identifies the Keyspace

Example

POST
https://stash.us.stedi.com/2022-04-20/CreateKeyspace

Delete Keyspace

POST/DeleteKeyspace
Delete a Keyspace.
Request body

application/json

keyspaceNameRequiredstring
The name that identifies the Keyspace

Example

POST
https://stash.us.stedi.com/2022-04-20/DeleteKeyspace

Delete Value

POST/DeleteValue

Delete a value in a table. This operation also returns the value as it existed in the moment before it was deleted.

Request body

application/json

keyspaceNameRequiredstring
The name that identifies the Keyspace
keyRequiredstring
The Key to set or get a Value with

Example

POST
https://stash.us.stedi.com/2022-04-20/DeleteValue

List Keyspaces

POST/ListKeyspaces
List all the Keyspaces.
Request body

application/json

pageSizeOptionalint32
The number of results to return. Default is 100. The value can range between 1 and 100.
nextPageTokenOptionalstring
The pagination token

Example

POST
https://stash.us.stedi.com/2022-04-20/ListKeyspaces

Get Keyspace

POST/GetKeyspace
Get a Keyspace.
Request body

application/json

keyspaceNameRequiredstring
The name that identifies the Keyspace

Example

POST
https://stash.us.stedi.com/2022-04-20/GetKeyspace

Increment Value

POST/IncrementValue

Increment a value.

Increment treats the initial value as 0 if no value exists for the key. Increment adds the given amount to the value. An error is thrown if the value exists and is not a number.

Request body

application/json

keyspaceNameRequiredstring
The name that identifies the Keyspace
amountRequiredAny
The amount to increment by. Must be a number.
keyRequiredstring
The Key to set or get a Value with

Example

POST
https://stash.us.stedi.com/2022-04-20/IncrementValue

Set Value

POST/SetValue

Set a Value in a Keyspace.

This operation will overwrite any previous Values that have been stored in the same Key.

Request body

application/json

keyspaceNameRequiredstring
The name that identifies the Keyspace
valueRequiredAny

The value associated with the key.

Can be any one of:

  • string
  • number
  • boolean
  • array
  • object
keyRequiredstring
The Key to set or get a Value with

Example

POST
https://stash.us.stedi.com/2022-04-20/SetValue

Get Value

POST/GetValue

Get a Value from a Keyspace. Always returns the latest Value that has been stored. Empty object is returned when the given key does not exist.

Request body

application/json

keyspaceNameRequiredstring
The name that identifies the Keyspace
keyRequiredstring
The Key to set or get a Value with

Example

POST
https://stash.us.stedi.com/2022-04-20/GetValue

List Values

POST/ListValues
List all the Values in a Keyspace.
Request body

application/json

keyspaceNameRequiredstring
The keyspace name
pageSizeOptionalint32

The number of results to return. If 1MB of results are processed before the pageSize is reached then the results fetched up to that point are returned. Default is to return up to 1MB of results. The value has a minimum of 1.

nextPageTokenOptionalstring
The pagination token

Example

POST
https://stash.us.stedi.com/2022-04-20/ListValues

Feedback

Have an idea for something we could improve? Page not clear? We love feedback - send us a message.

Stedi

Build EDI integrations fast, without being an EDI expert

Start building
About
ProductPricingCareersContactBlog
Documentation
CoreGuidesFunctionsAll DocsChangelog
Resources
EDI ReferenceEDI InspectorEDI Guide CatalogEDI Forum
Follow
  1. Twitter
  2. GitHub
Backed by
AdditionBloomberg BetaFirst RoundStripeUSV
Loading status...
Customer AgreementService TermsPrivacy Notice

Stedi is a registered trademark of Stedi, Inc. All names, logos, and brands of third parties listed on our site are trademarks of their respective owners (including “X12”, which is a trademark of X12 Incorporated). Stedi, Inc. and its products and services are not endorsed by, sponsored by, or affiliated with these third parties. Our use of these names, logos, and brands is for identification purposes only, and does not imply any such endorsement, sponsorship, or affiliation.