OpenAPI YAMLOpenAPI JSONproblems YAMLAPI overview
This group has 6 operations, generated from api/openapi.yaml. Filter by path, action, or authentication. Each endpoint lists its inputs; expand it for a request template and response codes. Templates need your own values and a schema-valid body.
Replace uppercase placeholders with your values. For a JSON request, save a body matching the schema in request.json. Cookie examples use a local cookie jar from an authenticated session.
Service metadata, capabilities and documentation search
Get Health
Request template and responses
curl --request GET 'https://api.screenrig.ai/.health'Responses
| Status | Meaning | Body and headers |
|---|---|---|
| 200 | Alive | HealthResponse (application/json) |
Get Readiness
Serving readiness. A draining host answers 421 server_draining with Retry-After: 1. A required dependency failure answers 500 not_ready with Retry-After. A live database schema that does not satisfy this release (a desired index missing or different for more than two minutes) answers 500 schema_incompatible without Retry-After: it does not clear by waiting.
Request template and responses
curl --request GET 'https://api.screenrig.ai/.ready'Responses
| Status | Meaning | Body and headers |
|---|---|---|
| 200 | Ready | ReadyResponse (application/json) |
| 421 | Stable RFC 9457 problem response on a Player-facing runtime, content, or probe route, in the runtime document shape (RuntimeProblem). A 421 server_draining carries Retry-After of 1 second, a 500 not_ready or dependency_unavailable carries 5, and a 500 manifest_degraded carries 60, unless the handler set a more specific value. | RuntimeProblem (application/problem+json) |
| 500 | Stable RFC 9457 problem response on a Player-facing runtime, content, or probe route, in the runtime document shape (RuntimeProblem). A 421 server_draining carries Retry-After of 1 second, a 500 not_ready or dependency_unavailable carries 5, and a 500 manifest_degraded carries 60, unless the handler set a more specific value. | RuntimeProblem (application/problem+json) |
Get Version
Request template and responses
curl --request GET 'https://api.screenrig.ai/.version'Responses
| Status | Meaning | Body and headers |
|---|---|---|
| 200 | Version | VersionResponse (application/json) |
Get Capabilities
Request template and responses
curl --request GET 'https://api.screenrig.ai/api/capabilities'Responses
| Status | Meaning | Body and headers |
|---|---|---|
| 200 | Capability and archive limits | Capabilities (application/json) |
Search the official documentation
Searches the official screenRIG documentation, the pages of screenrig.ai/docs, the problem types, pricing and the other customer pages, and answers the best matching sections, best first, at most limit (8 by default). Public: no credential is needed and the call is never charged.
A hit's url is its page (with the section's fragment where the page names one), section is the heading and snippet shows the text around the match; read the page or the section with getDocsPage. Held to 120 requests per client IP per minute (IPv6 grouped by /64).
The corpus reloads every 15 minutes; before the first load the route answers 500 not_ready with Retry-After.
Parameters
| Name | Send in | Required? | Description |
|---|---|---|---|
| q | query | required | Words, a command or flag, or an error code, 1 to 200 characters. |
| limit | query | optional |
Request template and responses
curl --request GET 'https://api.screenrig.ai/api/docs/search?q=Q'Responses
| Status | Meaning | Body and headers |
|---|---|---|
| 200 | The matching sections, best first. Empty when nothing matches. | DocsSearchResponse (application/json); headers: RateLimit-Policy, RateLimit |
| default | Stable RFC 9457 problem response. A 421 server_draining carries Retry-After of 1 second, a 500 not_ready or dependency_unavailable carries 5, and a 500 manifest_degraded carries 60, unless the handler set a more specific value. | Problem (application/problem+json) |
| 429 | Stable rate_limited problem. Retry only after the authoritative Retry-After interval. Fixed-window denials also include the applicable RateLimit-Policy and RateLimit members; concurrency and byte-budget denials omit those optional disclosures. | Problem (application/problem+json); headers: Retry-After, RateLimit-Policy, RateLimit |
Read an official documentation page or section
Answers an official documentation page, or with section one section of it with the sections under it, as Markdown. url is the page's address as searchDocs answers it, its .md form, or only its path, with or without a #fragment (a fragment names the section when section is not given). section is a heading or an anchor of the page, or part of a heading.
A section is cut at a line end within 48 KiB with truncated true; a whole page over 48 KiB answers its introduction with truncated true and its outline. sections lists the headings to read next (the page's, or the section's own sub-headings). Unknown pages and sections answer 404 not_found.
Public, never charged, and held to the same 120 requests per client IP per minute as searchDocs.
Parameters
| Name | Send in | Required? | Description |
|---|---|---|---|
| url | query | required | The page's address, 1 to 500 characters. |
| section | query | optional | A heading or anchor of the page, at most 200 characters. |
Request template and responses
curl --request GET 'https://api.screenrig.ai/api/docs/page?url=URL'Responses
| Status | Meaning | Body and headers |
|---|---|---|
| 200 | The page or section as Markdown. | DocsPage (application/json); headers: RateLimit-Policy, RateLimit |
| default | Stable RFC 9457 problem response. A 421 server_draining carries Retry-After of 1 second, a 500 not_ready or dependency_unavailable carries 5, and a 500 manifest_degraded carries 60, unless the handler set a more specific value. | Problem (application/problem+json) |
| 429 | Stable rate_limited problem. Retry only after the authoritative Retry-After interval. Fixed-window denials also include the applicable RateLimit-Policy and RateLimit members; concurrency and byte-budget denials omit those optional disclosures. | Problem (application/problem+json); headers: Retry-After, RateLimit-Policy, RateLimit |