Seren Cloud

Use this skill when a user wants to deploy or run skills in Seren-managed cloud runtime.

API

Use this skill alongside the core Seren API skill (https://api.serendb.com/skill.md).

Base Route

All routes go through https://api.serendb.com/publishers/seren-cloud.

Authentication

All endpoints require Authorization: Bearer $SEREN_API_KEY.

Deployments

Deploy new agents and manage deployment lifecycle operations.

Deploy a skill to seren-cloud.

POST /publishers/seren-cloud/deploy

curl -sS -X POST "https://api.serendb.com/publishers/seren-cloud/deploy" \
  -H "Authorization: Bearer $SEREN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code_bundle_base64":"","mode":"","name":"my-agent","skill_slug":"my-publisher"}'

List all deployments for the authenticated organization.

GET /publishers/seren-cloud/deployments

curl -sS -X GET "https://api.serendb.com/publishers/seren-cloud/deployments" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Get details of a specific deployment.

GET /publishers/seren-cloud/deployments/{id}

curl -sS -X GET "https://api.serendb.com/publishers/seren-cloud/deployments/<id>" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Delete a deployment and clean up compute resources.

DELETE /publishers/seren-cloud/deployments/{id}

curl -sS -X DELETE "https://api.serendb.com/publishers/seren-cloud/deployments/<id>" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Update config and/or secrets without redeploying code.

PATCH /publishers/seren-cloud/deployments/{id}

curl -sS -X PATCH "https://api.serendb.com/publishers/seren-cloud/deployments/<id>" \
  -H "Authorization: Bearer $SEREN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"config":{},"secrets":{}}'

Get logs for a deployment.

GET /publishers/seren-cloud/deployments/{id}/logs

curl -sS -X GET "https://api.serendb.com/publishers/seren-cloud/deployments/<id>/logs" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Start an always-on deployment (scale to 1 replica).

POST /publishers/seren-cloud/deployments/{id}/start

curl -sS -X POST "https://api.serendb.com/publishers/seren-cloud/deployments/<id>/start" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Stop an always-on deployment (scale to 0 replicas).

POST /publishers/seren-cloud/deployments/{id}/stop

curl -sS -X POST "https://api.serendb.com/publishers/seren-cloud/deployments/<id>/stop" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Runs

Execute one-off runs and inspect run history, logs, and artifacts.

List run events (history) for a deployment.

GET /publishers/seren-cloud/deployments/{id}/runs

curl -sS -X GET "https://api.serendb.com/publishers/seren-cloud/deployments/<id>/runs" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Run a one-shot invocation of a deployment.

POST /publishers/seren-cloud/deployments/{id}/runs

curl -sS -X POST "https://api.serendb.com/publishers/seren-cloud/deployments/<id>/runs" \
  -H "Authorization: Bearer $SEREN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Get a single run event for a deployment.

GET /publishers/seren-cloud/deployments/{id}/runs/{run_id}

curl -sS -X GET "https://api.serendb.com/publishers/seren-cloud/deployments/<id>/runs/<run_id>" \
  -H "Authorization: Bearer $SEREN_API_KEY"

List artifacts emitted by a specific deployment run.

GET /publishers/seren-cloud/deployments/{id}/runs/{run_id}/artifacts

curl -sS -X GET "https://api.serendb.com/publishers/seren-cloud/deployments/<id>/runs/<run_id>/artifacts" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Cancel a queued/running deployment run.

POST /publishers/seren-cloud/deployments/{id}/runs/{run_id}/cancel

curl -sS -X POST "https://api.serendb.com/publishers/seren-cloud/deployments/<id>/runs/<run_id>/cancel" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Stream updates for a deployment run as Server-Sent Events.

GET /publishers/seren-cloud/deployments/{id}/runs/{run_id}/stream

curl -sS -X GET "https://api.serendb.com/publishers/seren-cloud/deployments/<id>/runs/<run_id>/stream" \
  -H "Authorization: Bearer $SEREN_API_KEY"

List all runs across all deployments for the organization.

GET /publishers/seren-cloud/runs

curl -sS -X GET "https://api.serendb.com/publishers/seren-cloud/runs" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Get a single run event by ID (cross-agent).

GET /publishers/seren-cloud/runs/{run_id}

curl -sS -X GET "https://api.serendb.com/publishers/seren-cloud/runs/<run_id>" \
  -H "Authorization: Bearer $SEREN_API_KEY"

List artifacts emitted by a run event.

GET /publishers/seren-cloud/runs/{run_id}/artifacts

curl -sS -X GET "https://api.serendb.com/publishers/seren-cloud/runs/<run_id>/artifacts" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Cancel a queued/running run by ID.

POST /publishers/seren-cloud/runs/{run_id}/cancel

curl -sS -X POST "https://api.serendb.com/publishers/seren-cloud/runs/<run_id>/cancel" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Stream updates for a run as Server-Sent Events.

GET /publishers/seren-cloud/runs/{run_id}/stream

curl -sS -X GET "https://api.serendb.com/publishers/seren-cloud/runs/<run_id>/stream" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Environments

Manage reusable runtime environments for deployments.

List reusable execution environment profiles.

GET /publishers/seren-cloud/environments

curl -sS -X GET "https://api.serendb.com/publishers/seren-cloud/environments" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Create a reusable execution environment profile.

POST /publishers/seren-cloud/environments

curl -sS -X POST "https://api.serendb.com/publishers/seren-cloud/environments" \
  -H "Authorization: Bearer $SEREN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"docker_image":"","name":"my-agent"}'

Get a reusable execution environment profile.

GET /publishers/seren-cloud/environments/{id}

curl -sS -X GET "https://api.serendb.com/publishers/seren-cloud/environments/<id>" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Delete a reusable execution environment profile.

DELETE /publishers/seren-cloud/environments/{id}

curl -sS -X DELETE "https://api.serendb.com/publishers/seren-cloud/environments/<id>" \
  -H "Authorization: Bearer $SEREN_API_KEY"

Update a reusable execution environment profile.

PATCH /publishers/seren-cloud/environments/{id}

curl -sS -X PATCH "https://api.serendb.com/publishers/seren-cloud/environments/<id>" \
  -H "Authorization: Bearer $SEREN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description":"","docker_image":"","is_default":true}'