Deliver channel status

GET

/v1/artifacts/{id}/deliver

const url = 'https://shareout.site/v1/artifacts/example/deliver';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://shareout.site/v1/artifacts/example/deliver \
  --header 'Authorization: Bearer <token>'

Per-channel connection status for the Home Inspector Deliver section — whether Telegram is linked for the signed-in user, Slack is connected for the artifact workspace (with OAuth connectUrl when not), email is always available (with the caller’s own address), and the caller’s role.

Authorizations

bearerAuth

Parameters

Path Parameters

required

string

Artifact ID (e.g. art_abc123).

Responses

200

Channel status

application/json

object

telegram

object

linked

boolean

connectUrl

string

slack

object

available

boolean

connected

boolean

connectionName

string | null

connectUrl

string | null

email

object

available

boolean

address

The signed-in user’s own email — the default recipient.

string | null

role

Caller’s role on the artifact. Viewers may only schedule or deliver to themselves (own email, own Telegram, Slack DM).

string

Allowed values: owner editor viewer

Example

{
  "role": "owner"
}

403

Access denied

application/json

object

success

required

boolean

error

required

Human-readable message.

string

code

required

Machine-readable error code.

string

request_id

Correlation id (also the X-Request-Id header). Quote it in support tickets.

string

reason

Finer cause under code. For UNAUTHORIZED: missing, invalid, revoked or expired.

string

hint

What to do next, in plain words.

string

suggestion

string

param

The request field at fault.

string

docs

Doc page for this error.

string

redirect_url

string

support

Present on 5xx — how to reach a human.

object

how

string

include

Array<string>

Example

{
  "success": false,
  "support": {
    "how": "POST /v1/support/tickets",
    "include": [
      "request_id"
    ]
  }
}