Skip to main content
POST
Make a copy

Authorizations

Authorization
string
header
required

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.

Headers

Idempotency-Key
string

A caller-generated key for safely retrying this side effect. The server retains the key and response for 24 hours. Reusing it with the same request replays the original response, except after a failure that proves nothing happened: that is kept for one minute, and one that sets Retry-After is not kept, so a retry after it runs the request again; reusing it with different input returns 409.

Required string length: 1 - 128
Pattern: ^[!-~]+$
Example:

"req_01J6M6Y9TF9Q9QF6M1ZP8K4R2A"

Path Parameters

id
string
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.

Minimum string length: 1
Example:

"agent-atlas"

Body

application/json
name
string

Name for the copy; omit it for a generated one.

Maximum string length: 63
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$

Response

The copy and the receipt of its live release.

computer
object
required
release
object
required
url
string<uri>
required

The computer's URL, which serves the live release.

vm
boolean
required

Whether the computer's VM serves its URL, because a server on it answered.

next
object
required

What to do next: upload the missing hashes, finalize, or nothing (done).

release_url
string<uri>

This release's own hostname r--. Absent once the computer's VM serves its URL.