naftiko: 1.0.0-alpha2
info:
  label: Socket Org Snapshots Snapshots
  description: Socket org snapshots snapshots business capability. Self-contained Naftiko capability covering one Socket business surface.
  tags:
  - Socket
  - Supply Chain Security
  - Org
  - Snapshots
  - Snapshots
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    SOCKET_API_KEY: SOCKET_API_KEY
capability:
  consumes:
  - type: http
    namespace: org-snapshots-snapshots
    baseUri: https://api.socket.dev/v0
    description: Socket org snapshots snapshots business capability. Self-contained, no shared references.
    resources:
    - name: orgs-org-slug-historical-snapshots
      path: /orgs/{org_slug}/historical/snapshots
      operations:
      - name: get-orgs-org-slug-historical-snapshots
        method: GET
        description: List details of periodic historical data snapshots (Beta)
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: org_slug
          in: path
          type: string
          description: The slug of the organization
          required: true
        - name: date
          in: query
          type: string
          description: The UTC date in YYYY-MM-DD format for which to fetch snapshots
          required: false
        - name: range
          in: query
          type: string
          description: The number of days of data to fetch as an offset from input date (e.g. "-7d" or "7d") or use "latest" to query for latest snapshots for each repo
          required: false
        - name: per_page
          in: query
          type: integer
          description: Specify the maximum number of results to return per page (intermediate pages may have fewer than this limit and callers should always check "endCursor" in response body to know if
            there are more pages
          required: false
        - name: startAfterCursor
          in: query
          type: string
          description: The pagination cursor that was returned as the "endCursor" property in previous request
          required: false
        - name: filters.status
          in: query
          type: string
          description: 'Comma-separated list of historical snapshot statuses that should be included (allowed: "in-progress", "success", "failure", "timeout", "skipped")'
          required: false
        - name: filters.requestId
          in: query
          type: string
          description: Comma-separated list of requestId values that were used to start the historical snapshot job
          required: false
    authentication:
      type: basic
      username: '{{env.SOCKET_API_KEY}}'
      password: ''
      description: Socket authenticates via HTTP Basic with the API key as the username and empty password.
  exposes:
  - type: rest
    namespace: org-snapshots-snapshots-rest
    port: 8080
    description: REST adapter for Socket org snapshots snapshots.
    resources:
    - path: /v1/orgs/{org_slug}/historical/snapshots
      name: orgs-org-slug-historical-snapshots
      description: REST surface for orgs-org-slug-historical-snapshots.
      operations:
      - method: GET
        name: get-orgs-org-slug-historical-snapshots
        description: List details of periodic historical data snapshots (Beta)
        call: org-snapshots-snapshots.get-orgs-org-slug-historical-snapshots
        with:
          org_slug: rest.path.org_slug
          date: rest.query.date
          range: rest.query.range
          per_page: rest.query.per_page
          startAfterCursor: rest.query.startAfterCursor
          filters.status: rest.query.filters.status
          filters.requestId: rest.query.filters.requestId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: org-snapshots-snapshots-mcp
    port: 9090
    transport: http
    description: MCP adapter for Socket org snapshots snapshots.
    tools:
    - name: socket-get-orgs-org-slug-historical-snapshots
      description: List details of periodic historical data snapshots (Beta)
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: org-snapshots-snapshots.get-orgs-org-slug-historical-snapshots
      with:
        org_slug: tools.org_slug
        date: tools.date
        range: tools.range
        per_page: tools.per_page
        startAfterCursor: tools.startAfterCursor
        filters.status: tools.filters.status
        filters.requestId: tools.filters.requestId
      outputParameters:
      - type: object
        mapping: $.