com.publicdomainrelay.temp.tangled.spindle.trigger

Manually trigger a pipeline run on a Tangled spindle. Intended to be called via PDS service proxying (the 'atproto-proxy' header, pointed at the spindle's did:web service entry), so the user's PDS mints and signs the inter-service auth token; the spindle verifies the token's issuer against their DID document and requires it to match the trigger's 'actor'. Mirrors the sh.tangled.pipeline fields a knot dispatches on a push/PR event.

Details · procedure
Kindprocedure
Authorityspindle.tangled.temp.publicdomainrelay.com
Indexed

Procedure

procedure · POST

Input

application/json

actor

requiredstring · did

DID of the actor the run is attributed to. Must equal the issuer of the service-auth token.

inputs

unknown

Optional workflow_dispatch-style inputs, as a map of string keys to string values.

knot

requiredstring

Knot hostname that hosts the repo, e.g. knot1.tangled.sh.

pipelineRkey

requiredstring

Record key identifying this pipeline run; only needs to be unique per run.

ref

requiredstring

Commit SHA to run at. The spindle fetches .github/workflows/*.yml at this exact commit, so it must be a real commit, not a branch name.

repoDid

requiredstring · did

DID of the repo (the owner DID used for sh.tangled.repo.blob lookups).

repoName

requiredstring

Human-readable repo name, e.g. myrepo.

Output

application/json

knot

requiredstring

pipelineRkey

requiredstring

ref

requiredstring

submitted

requiredboolean

True once the trigger was accepted and workflow submission started.

workflows

requiredarray

The workflow stems that were submitted, with their log/status stream URLs.

itemsref
Reference

Errors

InvalidRequest

Malformed body or missing required fields.

Unauthorized

Missing or invalid inter-service auth token.

Forbidden

Token issuer does not match actor, or repo is not authorized for this spindle.

#workflowResult

object

Properties

logsUrl

string · uri

URL to the log stream for this workflow run.

statusUrl

string · uri

URL to the status stream for this workflow run.

workflow

requiredstring

Workflow stem that was submitted.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.