Skip to main content

List Partner Submissions (Admin)

List partner submissions owned by the caller's organization. Supports filtering by state, asset type, slug, and date range; cursor pagination. Requires an admin-scoped API key.

Parameters

NameTypeDefaultDescription
statestring-
assetTypestring-
slugstring-
createdAfterstring-
createdBeforestring-
limitinteger25
cursorstring-

Use Cases

  • List this org's partner submissions, newest first, with cursor pagination
  • Find all submissions still in draft (or in_review, rejected, approved)
  • Filter to a single asset type or slug, or a created-date range

Example Usage

First page of all submissions

{
"tool": "admin_list_submissions",
"arguments": {}
}

Only workflow drafts

{
"tool": "admin_list_submissions",
"arguments": {
"state": "draft",
"assetType": "workflow"
}
}

Submissions created within a date range

{
"tool": "admin_list_submissions",
"arguments": {
"createdAfter": "2026-08-01T00:00:00Z",
"createdBefore": "2026-08-27T00:00:00Z",
"limit": 50
}
}

Response Format

FieldTypeDescription
submissionsarraySubmissions page (up to limit items), ordered by (createdAt DESC, id DESC). Use nextCursor to fetch the next page.
submissions[].idstring
submissions[].slugstring
submissions[].assetTypestring
submissions[].statestring
submissions[].aiVerdictanyReconciled AI-review verdict matching what admin_validate_submission would return, or null when no review has run (or the parent summary was cleared by a re-submit).
submissions[].createdAtstring
submissions[].updatedAtstring
submissions[].publishedBlueprintIdstring | nullNon-null only when state='approved' and materialization has completed.
submissions[].lastRejectionReasonstring | nullSet when state='rejected'. Surfaces the human-readable reason persisted on the row.
submissions[].nextActionstringDerived hint for the caller's next call. Stable contract — see tool-reference docs for the catalog of strings.
nextCursorstring | nullOpaque cursor for the next page; null when no more results.