REST API

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

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

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

#Resources

• +
  Authentication and scopes
• +
  Preview uploads
• +
  GitHub builds
• +
  Test runs
• +
  Cloud sessions
• +
  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.