Skip to main content
Spin up a short-lived Salesforce REST mock for agents and evals. One snapshot = one org-shaped sandbox until the TTL expires.

​
How it works

  1. Create a snapshot with POST /providers/salesforce/create-snapshot (API key required).
  2. Call the returned base URL like a Salesforce instance: https://{snapshotId}.salesforce.mock.ressl.cc
  3. Paths follow normal Salesforce REST (v67.0 in examples below): sObjects, describe, SOQL /query, and so on.
  4. Seed loads initial records into memory. Config (optional) replaces describe metadata for this snapshot. Omit config to keep the emulator’s baked describes.
  5. GET /openapi on the snapshot base URL returns this provider’s OpenAPI document (single-provider snapshots only).
When the TTL ends, the sandbox is torn down. There is no list/delete API in v1. See also: Create snapshot, Quickstart.

​
Seed — records

seed is the world state: which sObjects exist and which rows they contain. Recommended shape: 
{
  "salesforce": {
    "<SObjectApiName>": [
      { "Id": "…", "Name": "…", "…": "…" }
    ]
  }
}
RuleBehavior
Omit seed or send nullStarts as { "salesforce": {} } (empty)
Omit the salesforce wrapperAPI wraps your object using the path slug
Collection keyssObject API names: Account, Contact, custom Foo__c, …
IdOptional on create via REST; for seeded rows, set realistic Ids (e.g. 001… for Account)

​
Seed template

{
  "salesforce": {
    "Account": [
      {
        "Id": "001xx000003DGbYAAW",
        "Name": "Acme Manufacturing",
        "BillingCity": "San Francisco",
        "BillingState": "CA",
        "BillingCountry": "USA"
      }
    ],
    "Contact": [
      {
        "Id": "003xx000004TmiRAAS",
        "AccountId": "001xx000003DGbYAAW",
        "FirstName": "Ada",
        "LastName": "Lovelace",
        "Email": "ada@acme.example"
      }
    ]
  }
}

​
Config — describe metadata

config is Salesforce describe JSON — the same shape as the emulator’s baked salesforce-describes.json.
RuleBehavior
Omit / nullKeep baked describes (Account, Contact, User, Case, Opportunity, Quote, and several custom objects already in the image)
SetFull replace for this snapshot (not a merge)
ShapeObject map keyed by sObject name, or an array of describe objects
Other providersconfig is only supported for salesforce (other slugs → 400)
The handler uses uploaded describes when present for an sObject; otherwise it can fall back from seeded field shapes. You decide how rich config is; a minimal describe is enough for many evals. Typical describe fields the mock cares about: name, label, keyPrefix, and fields[] entries with at least name, label, type (plus createable / updateable when relevant).

​
Config template

{
  "Account": {
    "name": "Account",
    "label": "Account",
    "keyPrefix": "001",
    "fields": [
      {
        "name": "Id",
        "label": "Account ID",
        "type": "id",
        "createable": false,
        "updateable": false
      },
      {
        "name": "Name",
        "label": "Account Name",
        "type": "string",
        "createable": true,
        "updateable": true
      },
      {
        "name": "BillingCity",
        "label": "Billing City",
        "type": "string",
        "createable": true,
        "updateable": true
      }
    ]
  },
  "Contact": {
    "name": "Contact",
    "label": "Contact",
    "keyPrefix": "003",
    "fields": [
      {
        "name": "Id",
        "label": "Contact ID",
        "type": "id",
        "createable": false,
        "updateable": false
      },
      {
        "name": "AccountId",
        "label": "Account ID",
        "type": "reference",
        "createable": true,
        "updateable": true,
        "referenceTo": ["Account"]
      },
      {
        "name": "FirstName",
        "label": "First Name",
        "type": "string",
        "createable": true,
        "updateable": true
      },
      {
        "name": "LastName",
        "label": "Last Name",
        "type": "string",
        "createable": true,
        "updateable": true
      },
      {
        "name": "Email",
        "label": "Email",
        "type": "email",
        "createable": true,
        "updateable": true
      }
    ]
  }
}

​
Example

Create a snapshot with the templates above: 
curl -sS -X POST "https://simulation.ressl.ai/providers/salesforce/create-snapshot" \
  -H "Authorization: Bearer rsk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "ttl": "1h",
    "seed": {
      "salesforce": {
        "Account": [
          {
            "Id": "001xx000003DGbYAAW",
            "Name": "Acme Manufacturing",
            "BillingCity": "San Francisco"
          }
        ],
        "Contact": [
          {
            "Id": "003xx000004TmiRAAS",
            "AccountId": "001xx000003DGbYAAW",
            "FirstName": "Ada",
            "LastName": "Lovelace",
            "Email": "ada@acme.example"
          }
        ]
      }
    },
    "config": {
      "Account": {
        "name": "Account",
        "label": "Account",
        "keyPrefix": "001",
        "fields": [
          { "name": "Id", "label": "Account ID", "type": "id", "createable": false, "updateable": false },
          { "name": "Name", "label": "Account Name", "type": "string", "createable": true, "updateable": true },
          { "name": "BillingCity", "label": "Billing City", "type": "string", "createable": true, "updateable": true }
        ]
      },
      "Contact": {
        "name": "Contact",
        "label": "Contact",
        "keyPrefix": "003",
        "fields": [
          { "name": "Id", "label": "Contact ID", "type": "id", "createable": false, "updateable": false },
          { "name": "AccountId", "label": "Account ID", "type": "reference", "createable": true, "updateable": true, "referenceTo": ["Account"] },
          { "name": "FirstName", "label": "First Name", "type": "string", "createable": true, "updateable": true },
          { "name": "LastName", "label": "Last Name", "type": "string", "createable": true, "updateable": true },
          { "name": "Email", "label": "Email", "type": "email", "createable": true, "updateable": true }
        ]
      }
    }
  }'
Response includes url. Then: 
SNAPSHOT_URL="https://snap_….salesforce.mock.ressl.cc"

# Read a seeded Account
curl -sS "$SNAPSHOT_URL/services/data/v67.0/sobjects/Account/001xx000003DGbYAAW"

# Object describe (reflects your config if you sent one)
curl -sS "$SNAPSHOT_URL/services/data/v67.0/sobjects/Account/describe"

# OpenAPI (single-provider snapshots)
curl -sS "$SNAPSHOT_URL/openapi" | head -c 200

# SOQL
curl -sS --get "$SNAPSHOT_URL/services/data/v67.0/query" \
  --data-urlencode "q=SELECT Id, Name FROM Account"

​
Notes

  • Snapshot URLs are public but unguessable until expiresAt.
  • Prefer seed-only when the baked schema is enough; add config when you need a custom or reduced describe surface.
  • For the generic create-snapshot contract (any provider), see Create snapshot.