CyCognito Audit Logs API

The Audit Logs API from CyCognito — 1 operation(s) for audit logs.

Operations 1

POST /v1/audit-log Retrieve audit logs #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/cycognito-audit-logs-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cycognito-audit-logs-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  version: 0.0.1
  title: CyCognito API V1 Reference Audit Logs API
  description: The CyCognito API V1 is a REST API that allows you to post and get data from our main data entities—assets and issues.
tags:
- name: Audit Logs
paths:
  /v1/audit-log:
    post:
      description: Access events and activities from the audit log within defined timeframes.
      security:
      - apiAuth: []
      summary: Retrieve audit logs
      tags:
      - Audit Logs
      parameters:
      - name: count
        in: query
        schema:
          type: integer
        required: false
        description: Defines the number of results to be retrieved. Defaults to 10 with a max limit of 1000.
      - name: offset
        in: query
        schema:
          type: integer
        required: false
        description: 'Sets the starting index for result retrieval, influenced by the `count` parameter. By default, `offset` is 0. Example: `offset` 3 with `count` 25 fetches results from index 75 to 99.'
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                properties:
                  field:
                    description: Field to apply the filter on. Typically, any field present in the response can be used.
                    allOf:
                    - type: string
                    example: created-at
                  op:
                    description: "Specifies the operation to apply on the desired field.\n            \n*Supported values:*  \n            \n* `is` – Searches for values that match the specified text exactly.  \n            \n* `not` – Searches for values that **do not** match the specified text exactly.  \n            \n* `in` – Filters entities for values that include the specified strings. Note that these should be *full strings* and not *substrings*—see `contains`.  \n            \n* `not-in` – Filters entities for values that do not include the specified strings. Note that these should be *full strings* and not *substrings*—see `contains`.  \n            \n* `only-in` – Filters **exclusively** so that only entities with the values specified will be searched. This operator is currently available only for the `organizations` and `tags` properties for assets and issues.  \n            \n* `between` – Searches by dates that are in between two specified values. Each date range should be placed in square brackets `[]`, in the format `<YYYY>-<MM>-<DD>T<HH>:<mm>:<ss>.<SSS>Z`, and separated by a comma—e.g., `[\"2022-01-01T00:00:00.000Z\", \"2022-12-31T23:59:59.999Z\"]`.  \n            \n* `not-between` – Searches by dates that are **not** in between two specified values. Each date range should be placed in square brackets `[]`, in the format `<YYYY>-<MM>-<DD>T<HH>:<mm>:<ss>.<SSS>Z`, and separated by a comma—e.g., `[\"2022-01-01T00:00:00.000Z\", \"2022-12-31T23:59:59.999Z\"]`.  \n            \n* `within-range` – Searches by number values that are in between a specified range. Each range should be placed in square brackets `[]` and separated by a comma—e.g., `[60,75]`.\n            \n* `not-within-range` – Searches by number values that are **not** in between a specified range. Each range should be placed in square brackets `[]` and separated by a comma—e.g., `[10,59]`.\n            \n* `within-last` – Searches for date values that are within the specified time frame in days—e.g., `64` is the value for 64 days.\n            \n* `not-within-last` – Searches for date values that are **not** within the specified time frame in days—e.g., `128` is the value for 128 days.\n            \n* `contains` – Searches for a specific substring within a string value."
                    allOf:
                    - type: string
                      enum:
                      - is
                      - not
                      - in
                      - not-in
                      - only-in
                      - key-of
                      - not-key-of
                      - between
                      - not-between
                      - within-range
                      - not-within-range
                      - contains
                      - within-last
                      - not-within-last
                    example: between
                  values:
                    description: Specifies the value or values for the field.
                    type: array
                    items:
                      $ref: '#/components/schemas/json.any'
                    example:
                    - - '2026-07-02T01:56:10.859Z'
                      - '2026-07-09T01:56:10.861Z'
                required:
                - field
                - op
                - values
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    attached-file-id:
                      description: If an event involved file uploads or attachments, this field contains the unique identifier for that file, allowing for easy retrieval or reference.
                      anyOf:
                      - type: string
                      - type: 'null'
                      example: abcd-123456-efgh-7890
                    created-at:
                      description: "A timestamp indicating when the event or action was executed. \n*Format:* `yyyy-mm-ddTHH:mm:ssZ`"
                      type: string
                      format: date-time
                      example: '2024-05-18T13:09:08.557Z'
                    details:
                      description: Additional context or information related to the event, providing more granularity about the executed action.
                      anyOf:
                      - type: string
                      - type: 'null'
                      example: Asset tags were added to 'Acme Homes'
                    event:
                      description: A concise descriptor of the action or activity that took place, like *Asset removed* or *Team member signed in*.
                      type: string
                      example: Asset tags added
                    target-ids:
                      description: An array of unique identifiers associated specifically with the targeted assets affected by the event. Useful for tracing specific assets related to the action.
                      anyOf:
                      - type: array
                        items:
                          anyOf:
                          - type: string
                          - type: 'null'
                        uniqueItems: true
                      - type: array
                        items:
                          anyOf:
                          - type: string
                          - type: 'null'
                      - type: 'null'
                      example: "[\n \"domain/example.com\"\n ]"
                    target-type:
                      description: Specifies the type of entity the event is related to, such as *asset*, *issue*, or *org*. Helps in categorizing the event's context.
                      anyOf:
                      - type: string
                      - type: 'null'
                      example: Asset
                    team-id:
                      description: A unique identifier assigned to the team related to the event or action. This aids in filtering events by team-specific activities.
                      anyOf:
                      - type: string
                      - type: 'null'
                      example: 1234a5678bcd
                    team-name:
                      description: The official name of the team related to the event or action. Provides a human-readable reference for the associated team.
                      anyOf:
                      - type: string
                      - type: 'null'
                      example: Acme Homes
                    user-email:
                      description: The email address associated with the user who performed the action. Useful for communication or verification purposes.
                      anyOf:
                      - type: string
                      - type: 'null'
                      example: marty@acme.com
                    user-id:
                      description: A unique identifier assigned to the user, aiding in distinguishing different platform users.
                      type: string
                      example: asdf1234qwer5678
                    user-name:
                      description: The full name of the user who performed the action.
                      anyOf:
                      - type: string
                      - type: 'null'
                      example: Marty McFly
                    user-role:
                      description: The specific role assigned to the user within the platform, such as Admin, User, or Guest. Determines the user's access and privileges.
                      anyOf:
                      - type: string
                      - type: 'null'
                      example: admin
                  required:
                  - attached-file-id
                  - created-at
                  - details
                  - event
                  - target-ids
                  - target-type
                  - team-id
                  - team-name
                  - user-email
                  - user-id
                  - user-name
                  - user-role
                  additionalProperties: false
      operationId: postV1AuditLog
      x-operation-id-source: derived
components:
  schemas:
    json.any:
      anyOf:
      - type: string
      - type: boolean
      - type: number
      - type: string
        format: dateTime
      - type: string
        format: byte
      - type: array
        items:
          $ref: '#/components/schemas/json.any'
      - type: object
        additionalProperties:
          $ref: '#/components/schemas/json.any'
      - type: 'null'
  securitySchemes:
    apiAuth:
      type: apiKey
      name: Authorization
      in: header