List published Apps
Every published App in your organization, with the services each one enables and the Transaction Service schemas. Contracts come from each App's published version, so what is listed here is exactly what the execute endpoints serve.
Requires the apps:read scope. Paged: every answer carries nextCursor (FWA-2815); ?fields= keeps the payload small.
Authorization
apiKey An organization API key, created from a Portal's Webhooks page (Provisioning API card). The secret is shown once at creation and stored only as a hash. Keys are organization-wide and carry scopes (end_users:read, end_users:write). Rate limit: 120 requests per minute per key (sliding 60-second window).
In: header
Query Parameters
drafts lists unpublished Apps too, with published and updatedAt per row. Needs the apps:write scope.
Value in
- "drafts"
Items per page (default 50, max 200).
1 <= value <= 200The nextCursor from the previous page. Omit for the first page. A cursor names the last item handed out, so a walk is gapless; a stale one is refused with invalid_request.
Comma-separated field names to keep on each item. Published listing: id, name, description, services, inputSchema, outputSchema. With include=drafts: id, name, description, published, updatedAt. An unknown name is invalid_request naming the valid ones.
Only items changed at or after this time (inclusive).
date-timeResponse Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/apps"{ "apps": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "description": "string", "services": { "conversation": true, "transaction": true }, "inputSchema": {}, "outputSchema": {} } ], "nextCursor": "string"}