Catalog App URL Patterns

GET /catalog-apps/{catalog_app_id}/url-patterns

Returns a paginated list of URL patterns associated with a specific catalog app. URL patterns are the rules the system uses to match observed web URLs to a catalog application (e.g. *.google.com, mail.google.com/*).

Path Parameters

Parameter	Type	Description
catalog_app_id	string (uuid)	Unique identifier for the catalog app

Query Parameters

Parameter	Type	Default	Description
q	string	-	Search filter against pattern (case-insensitive, partial match)
sort_by	string	pattern	Sort field: pattern, created_at
sort_order	string	asc	Sort direction: asc, desc
page_size	integer	50	Items per page. Max: 500
cursor	string	-	Pagination cursor from a previous response

Response

Field	Type	Description
data	UrlPattern[]	Array of URL pattern objects
total_count	integer	Total number of URL patterns for this catalog app
next_cursor	string | null	Cursor to pass as cursor for the next page. null when on the last page.

Example Request

curl -X GET "https://api.example.com/v2/catalog-apps/a1b2c3d4-e5f6-7890-abcd-ef1234567890/url-patterns" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Example Response

{
  "data": [
    {
      "id": "11223344-5566-7788-99aa-bbccddeeff00",
      "pattern": "*.google.com"
    },
    {
      "id": "22334455-6677-8899-aabb-ccddeeff0011",
      "pattern": "chrome.google.com/*"
    },
    {
      "id": "33445566-7788-99aa-bbcc-ddeeff001122",
      "pattern": "chromewebstore.google.com/*"
    }
  ],
  "total_count": 3,
  "next_cursor": null
}

Pagination

This endpoint uses cursor-based pagination.

1. Omit cursor on the first request
2. If next_cursor is not null, pass its value as cursor on the next request
3. Repeat until next_cursor is null

Error Responses

Status	Description
400	Invalid query parameters (e.g. unknown sort_by value)
401	Authentication required
403	Insufficient permissions
404	Catalog app not found
500	Server error

Example Error Response

{
  "error": {
    "code": "not_found",
    "message": "Catalog app not found",
    "details": {
      "catalog_app_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
    }
  }
}

Related Endpoints

• Get Catalog App - Full catalog app profile
• Catalog App Desktop Aliases - Desktop process aliases for a catalog app