API ReferenceTasks

Create Task Share

Create a shareable link for a task. Share links allow external users to: - View task details without authentication - Run tasks with pre-configured inputs - Access task results Configure share settings: - Expiration time (in hours) - Usage limits (maximum number of uses) - Custom short link identifier (optional) - Allowed inputs - Output visibility Share links are perfect for demos, external testing, and public task access.

Authentication

AuthorizationBearer

Bearer token authentication using JWT tokens from Ory Kratos/Hydra

Path parameters

org_idstringRequiredformat: "uuid"
The unique identifier of the organization.
project_idstringRequiredformat: "uuid"
The unique identifier of the project.
task_idstringRequiredformat: "uuid"
The specific Task to reference.

Request

This endpoint expects an object.
titlestring or nullOptional
descriptionstring or nullOptional
expires_atstring or nullOptionalformat: "date-time"
task_revision_idstring or nullOptionalformat: "uuid"
task_run_idstring or nullOptionalformat: "uuid"
Optional TaskRun ID to include as an example. Must belong to the task revision being shared.
custom_short_idstring or nullOptionalformat: "^[a-zA-Z0-9]+$"3-5 characters

Response

Successful Response
idstringformat: "uuid"
task_idstringformat: "uuid"
task_revision_idstringformat: "uuid"
user_idstringformat: "uuid"
short_idstring
share_urlstring
views_countinteger
activeboolean
createdstring
modifiedstring
titlestring or null
descriptionstring or null
expires_atstring or null
task_run_idstring or nullformat: "uuid"
Optional TaskRun ID included as an example of the task's performance.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
500
Internal Server Error