Skip to content

Deliver artifact now

POST
/v1/artifacts/{id}/deliver
curl --request POST \
--url https://shareout.site/v1/artifacts/example/deliver \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "action": "email", "config": {} }'

One-shot delivery to email, Slack, or Telegram — same destination registry as scheduled jobs (action + config). Viewers may only deliver to themselves on Slack/Telegram.

id
required
string

Artifact ID (e.g. art_abc123).

Media type application/json
object
action
required
string
Allowed values: email slack telegram
config
required

Same shape as job config for the chosen action.

object

Delivery succeeded

Media type application/json
object
success
boolean
steps
Array<object>
object
Example generated
{
"success": true,
"steps": [
{}
]
}

Invalid request

Media type application/json
object
success
required
boolean
error
required

Human-readable message.

string
code
required

Machine-readable error code.

string
Example
{
"success": false
}

Access denied

Media type application/json
object
success
required
boolean
error
required

Human-readable message.

string
code
required

Machine-readable error code.

string
Example
{
"success": false
}

Delivery failed