analytics

GET /analytics/logs/package/{workspace}/

Changed on

Returns package log events, including uploads, copies, deletes, etc.

Request

  • Base URL
    https://api.cloudsmith.io/v2
  • Auth
    • API key in header X-Api-Key
    • or HTTP basic

Path parameters

workspacestring required

The name of the Workspace.

Query parameters

end_timestring date-time

End of the time range to filter logs. End time is exclusive, i.e. an end time of 2025-01-01 results in a query that returns logs with a timestamp of before 2025-01-01T00:00:00.

event_actionstring[]

Type of sync action by which to filter logs (e.g. SYNC, DELETE, COPY). Multiple actions can be provided e.g. event_action=SYNC&event_action=DELETE.

event_actorstring[]

Actor slug or unique identifier (slug-perm) by which to filter logs. Multiple actors can be provided e.g. event_actor=my-user&event_actor=W9iD9l2rNnrk.

event_actor_typestring[]

Type of actor by which to filter logs (e.g. USER, SERVICE). Multiple types can be provided e.g. event_actor_type=USER&event_actor_type=SERVICE.

format'csv' | 'json'

Response format. Use json (default) for a paginated JSON response, or csv to download the results as CSV.

packagestring[]

Package name or unique identifier (slug-perm) by which to filter logs. Multiple values can be provided e.g. package=my-package&package=W9iD9l2rNnrk.

package_formatstring[]

Type of package formats by which to filter logs (e.g. Nuget, Cargo, Raw). Multiple formats can be provided e.g. package_format=Nuget&package_format=Cargo.

pageinteger

A page number within the paginated result set.

page_sizeinteger

Number of results to return per page.

querystring

A search string for filtering logs. Legal prefixes are package (alias name), package_format (alias format), event_action, event_actor, event_actor_type, repository and version; a term with no prefix matches the package name or identifier. Boolean operators may be used to construct intricate queries. Omitting boolean operators is interpreted as an implicit AND. The expression is combined (AND) with any other filter parameters.

repositorystring[]

List of repositories for filtering logs. Multiple repositories can be provided e.g. repository=test-repo&repository=another-repo.

start_timestring date-time

Start of the time range to filter logs. Start time is inclusive, i.e. a start time of 2025-01-01 results in a query that returns logs with a timestamp starting from 2025-01-01T00:00:00.

Response

Changes

    • warning

      added the new HIDDEN enum value to the ////// response property for the response status

    • info

      added the enum value HIDDEN to the property items/ of the query request parameter event_action

    • warning

      added the new SKILLS enum value to the /////////// response property for the response status

    • info

      added the enum value SKILLS to the property items/ of the query request parameter package_format