Ship and share

Outbox

Files published to a public address, with no sign-in

On this page(3 sections)

What is published to the internet
Put a file on the internet
Take something off the internet

What the outbox holds and its address. Publishing copies a workspace file or folder in; withdrawing the last one removes the outbox, so its existing always means exactly "something is published". There is no route to read a published file back, because that is what the open address is for.

GET/publicWhat is published to the internet

Everything currently in the outbox and the address it answers on. There is no call to read a published file back: it is served openly to anyone with the link, which is the entire point of having put it there.

What you send

Nothing. Call it as it is.

What comes back

Field	Type
`url`Your public address, which every file's…	string
`files`What the outbox holds	object[]
`path`Where it sits inside the outbox	string
`size`Size in bytes	number
`modifiedAt`When it last changed, in milliseconds	number
`url`Its public address	string
`blocked`Why a file sitting in the…	string

Try itanswered in this tab

curl

curl "$SANDBOX/public" \
  -H "x-intentic-control: $INTENTIC_TOKEN"

TypeScript

import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.public.list();

POST/public/publishPut a file on the internet

Copies a workspace file or folder into the outbox, where it is served to anyone with the link and no sign-in. Answers with the address.

What you send

Field	Type	Where
`path`requiredWhat to publish, as a workspace…	string	body

What comes back

Field	Type
`path`Where it landed inside the outbox	string
`url`Its public address	string

Try itanswered in this tab

curl

curl -X POST "$SANDBOX/public/publish" \
  -H "x-intentic-control: $INTENTIC_TOKEN" \
  -H "content-type: application/json" \
  -d '{"path":"src/app.ts"}'

TypeScript

import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.public.publish({
  "path": "src/app.ts"
});

POST/public/unpublishTake something off the internet

Withdraws one published entry. When the last one goes, the outbox goes with it, so its existing at all always means something is published.

What you send

Field	Type	Where
`path`requiredWhat to withdraw, as a path…	string	body

What comes back

Field	Type
`ok`Always true	true

Try itanswered in this tab

curl

curl -X POST "$SANDBOX/public/unpublish" \
  -H "x-intentic-control: $INTENTIC_TOKEN" \
  -H "content-type: application/json" \
  -d '{"path":"src/app.ts"}'

TypeScript

import { sandbox } from "@intentic/sandbox-client";

const result = await sandbox.public.unpublish({
  "path": "src/app.ts"
});