REST API

The SootSim REST API exposes previews, builds, and test runs at https://contrast.dev/api/v1. Every request uses an account-scoped SootSim API key or a session Bearer token from sootsim login. Every created result links to a hosted page on https://sootsim.com.

curl https://contrast.dev/api/v1/builds\
  ?owner=acme\&repo=mobile\&branch=main\&platform=ios \
  -H "Authorization: Bearer $SOOTSIM_API_KEY"

API keys are available in Billing → API Keys on both Contrast and SootSim. Choose only the scopes an integration needs and set an expiration for production automation. The SootSim CLI can use its existing login session.

#Resources

• Authentication and scopes
• Hosted previews
• GitHub builds
• Test runs
• Billing and rate limits
• Request rate limits
• Error reference

All request and response bodies are JSON unless an upload URL explicitly asks for artifact bytes. Dates are ISO 8601 strings. Stored timestamps in resource responses are Unix milliseconds.