Tables

tables is Skippr Cloud’s managed document store. Applications read and write items with partition (and optional sort) keys, secondary indexes, and conditional updates. The wire protocol is DynamoDB-compatible for convenience; storage is FoundationDB — see Tables vs DynamoDB.

Status: Preview — DynamoDB JSON against live regional tables. Op list matches compat/matrix.yaml (partial).

Quickstart

1. Obtain Cloud credentials (SigV4 access key or JWT via gateway).
2. Point your AWS SDK / boto3 at https://api.cloud.skippr.io (or regional tables.eu-central-1.cloud.skippr.io when routed through gateway).
3. Use service name dynamodb, region eu-central-1, and X-Amz-Target: DynamoDB_20120810.<Operation>.
4. Create a table, put items, query by partition key — same shapes as AWS DynamoDB JSON.

# Example shape — production calls MUST use SigV4 (or JWT) via gateway
curl -sS -X POST "https://api.cloud.skippr.io/" \
  -H "Content-Type: application/x-amz-json-1.0" \
  -H "X-Amz-Target: DynamoDB_20120810.ListTables" \
  -d '{}'

Concepts

Term	Meaning
Table	Named collection of items with a key schema
Item	Map of attributes (string, number, binary, bool, null, list, map, sets)
Primary key	Partition key, or partition + sort key
GSI	Global secondary index for alternate query patterns
Condition	Predicate that must hold for a write to succeed

Access

Hostname	tables.eu-central-1.cloud.skippr.io (via gateway)
Protocol	HTTP POST, Content-Type: application/x-amz-json-1.0
Target	X-Amz-Target: DynamoDB_20120810.<Operation>
Auth	SigV4 service name dynamodb, region eu-central-1, or Cloud JWT via gateway
Tenancy	Bound to your Cloud account; do not send cross-tenant ids

Operations

Operation	Notes
CreateTable / DescribeTable / ListTables / DeleteTable	DDL
UpdateTable	GSI add/drop, stream flag; throughput accepted as no-op
GetItem / PutItem / UpdateItem / DeleteItem	Point ops; conditionals supported
Query / Scan	Query preferred; Scan is expensive
BatchGetItem / BatchWriteItem	Batch
TransactWriteItems / TransactGetItems	ACID multi-item (single FDB transaction)
UpdateTimeToLive / DescribeTimeToLive	TTL attribute configuration
ProjectionExpression	Partial attribute return on reads

Throughput fields on Create/Update may be accepted and ignored; responses report ignored fields via x-cloud-ignored (see compat docs when published).

Out of scope: DynamoDB Streams shard APIs (GetShardIterator / GetRecords). Table change data, when enabled via StreamSpecification, uses Cloud’s plain JetStream CDC log — not the AWS Streams API, not Cloud streams (append log), and not Cloud queue (SQS).

Limits (Preview)

Limit	Value
Item size	≤ 400 KiB
Region	eu-central-1

Related

• Tables vs DynamoDB — FoundationDB engine, API differences, what is intentionally not DynamoDB
• Gateway — edge auth and routing
• Auth — credentials and ABAC
• Roadmap