API · Projects · List projects of a type (Project or AdCreativeProject)
List projects of the given resourcetype in the workspace, paginated and
newest-first. Returns project objects with their UUIDs — needed for
getProject, listProjectItems, and deleteProject. Filter with
?search=<title>. Pass the same resourcetype you created the projects with.
Authentication
Header authentication of the form Api-Key <token>
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
Project type selector (the model name). The API is polymorphic — the same URL structure serves different project types based on this value. Valid values:
Project— generic projects (the default for most content).AdCreativeProject— ad-creative projects (specialized fields). Use the same value on create, get, list, and delete for a given project.
Query parameters
Filter by a SINGLE primary type — not a comma-separated list; the
server rejects anything over 24 characters. Values are free-form and
case-sensitive, e.g. ad, image, quote, thumbnail,
AIAvatarVideo, UGCVideo, SMQuotes, ImageYTThumb. Call
without this parameter to list every type, then filter client-side.
Return only the projects recorded while working in one conversation.
Pass current for the conversation you are in — the toolkit replaces
it with the real thread id, so an id you compose yourself is ignored.
Comma-separated fields to expand inline. Pass items to get each
project's deliverables in the same response instead of calling
listProjectItems per project.