---
title: "Read document editing access and live version"
description: "Reads the live artifact.json of a document artifact. Public documents allow signed-out reads; private documents require the owner or an active share member."
canonical: "https://www.cool.computer/docs/api-reference/files/read-document-editing-access-and-live-version"
---
# Read document editing access and live version

> Reads the live artifact.json of a document artifact. Public documents allow signed-out reads; private documents require the owner or an active share member.

```http
GET https://api.cool.computer/api/computers/{id}/files/document
```

Reads the live artifact.json of a document artifact. Public documents allow signed-out reads; private documents require the owner or an active share member. Returns the immutable computer_id, can_save, opaque version and, when read-only, reason signed_out, read_only or not_document. Works when comments are off. A live release without a valid document declaration remains readable with can_save false and its current version. Poll every 20 seconds while visible and on visibility return or focus. With since equal to the current version and access confirmed for this session within two minutes, returns the complete cached can_save, reason and version answer; public polls do not consult sharing or decode the manifest. Apply can_save and reason in every window, even when the version is unchanged. The version describes the live release, not the bytes already loaded: keep the release that supplied those bytes as the save base and reload matching document files before adopting a different version. The document layer revokes access on 401, 403 or 404; other failed reads retain the previous access. Once the site has a VM, full reads and version polls return 200 with can_save false, reason read_only and the retained release version, overriding cached editing rights. Browser sessions and account bearer tokens are accepted. A browser session's document reads and saves (this route and its POST) share one separate budget of 600 requests a minute per account (document), apart from its app requests, so a burst of reads can delay a save; account bearer requests spend the account's read or mutation budget, and signed-out reads spend the 60-request source budget per IP (IPv6 /64).

## Authorization

- A Cool Computers API key, user access token, or claimed agent access token in the Authorization header. Follow https://www.cool.computer/auth.md for agent registration and https://www.cool.computer/authentication.md for direct user credentials.
- No credential: the request is also answered without one.

## Parameters

- `id` (path, string, at least 1 characters, required): The computer's name, such as agent-atlas, or its id (cmp_…). Every caller may use either, the computer's own runtime token included.
- `since` (query, string): Last access version. An unchanged public version with access confirmed for this session within two minutes returns the complete cached access answer without artifact or sharing reads; apply can_save and reason in every window.

## Responses

- `200`: Document access and live release.
  - `application/json` (object)
    - `computer_id` (string, required)
    - `can_save` (boolean, required)
    - `version` (string, required)
    - `reason` ("signed_out" or "read_only" or "not_document")
- `401`: Unauthorized.
- `404`: A machine-readable API error with a stable code and recovery instruction.
- `429`: Too Many Requests. If the problem code is api_request_rate_exceeded, wait for Retry-After seconds; other problem codes describe a separate limit.
- `default`: A machine-readable API error with a stable code and recovery instruction.

An error is an `application/problem+json` document with a stable `code`; [API errors](/docs/api-reference/errors) says how to handle one.

## Example

```sh
curl "https://api.cool.computer/api/computers/$PARAM_ID/files/document" \
  -H "authorization: Bearer $TOKEN"
```
