List finished tasks

GET

/v1/triggers

curl --request GET \
  --url 'https://api.gopromptless.ai/v1/triggers?limit=50&offset=0' \
  --header 'Authorization: Bearer <token>'

Lists the organization’s finished tasks, newest completion first, including tasks that made no documentation change. Only finished tasks appear; follow a running task with GET /v1/triggers/{trigger_event_id}. Filter with source, bound with since, and page with limit and offset.

Authorizations

• bearerAuth

Parameters

Query Parameters

since

string format: date-time

ISO 8601 timestamp used as an inclusive lower limit on the completion timestamp. A trailing Z is accepted, and a value without a timezone is read as UTC. A task whose completion timestamp equals this value is returned again, so deduplicate by trigger_event_id and finished_at together. A task that Promptless reopens and finishes again returns with the same trigger_event_id and a new finished_at.

source

string

Exact trigger source to return, such as api. Omit to return every source.

limit

integer

default: 50 >= 1 <= 100

Maximum number of tasks to return.

offset

integer

0

Number of tasks to skip before returning results.

Responses

200

A page of finished tasks, newest completion first.

Media typeapplication/json

FinishedTasksResponse

A page of finished tasks from the finished-task feed, newest completion first.

object

tasks

required

Tasks

The finished tasks in this page, newest completion first.

Array<object>

FinishedTask

One finished task in the finished-task feed.

object

trigger_event_id

required

Trigger Event Id

The task’s id, the same id POST /v1/triggers returned. A task that Promptless reopens and finishes again appears again with this id, so deduplicate the feed on this value and finished_at together.

string format: uuid

source

required

Source

The task’s origin, such as api.

string

request

required

Request

A one-line summary of the submitted request.

string | null

outcome

required

Outcome

How the task ended. Null for tasks that finished before Promptless added this field and for tasks from sources other than the API or MCP. Promptless may add values later.

string | null

Allowed values: suggestions_created no_change_needed needs_input failed

resolution

required

Resolution

A note that explains how the task ended.

string | null

submitted_at

required

Submitted At

ISO 8601 time the task was submitted.

string format: date-time

finished_at

required

Finished At

ISO 8601 time the task finished.

string format: date-time

Example

{
  "tasks": [
    {
      "trigger_event_id": "d3aa7c40-5ec4-48c6-8d10-81c2ee042690",
      "outcome": "suggestions_created"
    }
  ]
}

400

The since parameter is not a valid ISO 8601 timestamp (invalid_since).

Media typeapplication/json

ApiTriggerErrorResponse

Error body returned when an API trigger request is rejected.

object

error

required

Error

Stable machine-readable error code.

string

message

required

Message

Human-readable explanation of the error.

string

Example

{
  "error": "authentication_failed",
  "message": "Authentication failed."
}

401

The API key is missing, invalid, or revoked.

Media typeapplication/json

ApiTriggerErrorResponse

Error body returned when an API trigger request is rejected.

object

error

required

Error

Stable machine-readable error code.

string

message

required

Message

Human-readable explanation of the error.

string

Example

{
  "error": "authentication_failed",
  "message": "Authentication failed."
}

422

A query parameter is out of range, such as a limit above 100 or a negative offset.

Media typeapplication/json

HTTPValidationError

Validation error body returned when the request fails schema validation.

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

Example^generated

{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}

503

The read store is temporarily unavailable (runtime_store_unavailable).

Media typeapplication/json

ApiTriggerErrorResponse

Error body returned when an API trigger request is rejected.

object

error

required

Error

Stable machine-readable error code.

string

message

required

Message

Human-readable explanation of the error.

string

Example

{
  "error": "authentication_failed",
  "message": "Authentication failed."
}