naftiko: 1.0.0-alpha2
info:
  label: SigNoz — serviceaccount
  description: 'SigNoz — serviceaccount. 14 operations. Lead operation: List service accounts. Self-contained Naftiko capability
    covering one Signoz business surface.'
  tags:
  - Signoz
  - serviceaccount
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SIGNOZ_API_KEY: SIGNOZ_API_KEY
capability:
  consumes:
  - type: http
    namespace: signoz-serviceaccount
    baseUri: https://{host}:{port}{base_path}
    description: SigNoz — serviceaccount business capability. Self-contained, no shared references.
    resources:
    - name: api-v1-service_accounts
      path: /api/v1/service_accounts
      operations:
      - name: listserviceaccounts
        method: GET
        description: List service accounts
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: createserviceaccount
        method: POST
        description: Create service account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v1-service_accounts-me
      path: /api/v1/service_accounts/me
      operations:
      - name: getmyserviceaccount
        method: GET
        description: Gets my service account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: updatemyserviceaccount
        method: PUT
        description: Updates my service account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v1-service_accounts-id
      path: /api/v1/service_accounts/{id}
      operations:
      - name: deleteserviceaccount
        method: DELETE
        description: Deletes a service account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
      - name: getserviceaccount
        method: GET
        description: Gets a service account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
      - name: updateserviceaccount
        method: PUT
        description: Updates a service account
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v1-service_accounts-id-keys
      path: /api/v1/service_accounts/{id}/keys
      operations:
      - name: listserviceaccountkeys
        method: GET
        description: List service account keys
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
      - name: createserviceaccountkey
        method: POST
        description: Create a service account key
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v1-service_accounts-id-keys-fid
      path: /api/v1/service_accounts/{id}/keys/{fid}
      operations:
      - name: revokeserviceaccountkey
        method: DELETE
        description: Revoke a service account key
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: fid
          in: path
          type: string
          required: true
      - name: updateserviceaccountkey
        method: PUT
        description: Updates a service account key
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: fid
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v1-service_accounts-id-roles
      path: /api/v1/service_accounts/{id}/roles
      operations:
      - name: getserviceaccountroles
        method: GET
        description: Gets service account roles
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
      - name: createserviceaccountrole
        method: POST
        description: Create service account role
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
    - name: api-v1-service_accounts-id-roles-rid
      path: /api/v1/service_accounts/{id}/roles/{rid}
      operations:
      - name: deleteserviceaccountrole
        method: DELETE
        description: Delete service account role
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          required: true
        - name: rid
          in: path
          type: string
          required: true
    authentication:
      type: bearer
      token: '{{env.SIGNOZ_API_KEY}}'
  exposes:
  - type: rest
    namespace: signoz-serviceaccount-rest
    port: 8080
    description: REST adapter for SigNoz — serviceaccount. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/api/v1/service-accounts
      name: api-v1-service-accounts
      description: REST surface for api-v1-service_accounts.
      operations:
      - method: GET
        name: listserviceaccounts
        description: List service accounts
        call: signoz-serviceaccount.listserviceaccounts
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createserviceaccount
        description: Create service account
        call: signoz-serviceaccount.createserviceaccount
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/service-accounts/me
      name: api-v1-service-accounts-me
      description: REST surface for api-v1-service_accounts-me.
      operations:
      - method: GET
        name: getmyserviceaccount
        description: Gets my service account
        call: signoz-serviceaccount.getmyserviceaccount
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updatemyserviceaccount
        description: Updates my service account
        call: signoz-serviceaccount.updatemyserviceaccount
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/service-accounts/{id}
      name: api-v1-service-accounts-id
      description: REST surface for api-v1-service_accounts-id.
      operations:
      - method: DELETE
        name: deleteserviceaccount
        description: Deletes a service account
        call: signoz-serviceaccount.deleteserviceaccount
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: getserviceaccount
        description: Gets a service account
        call: signoz-serviceaccount.getserviceaccount
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updateserviceaccount
        description: Updates a service account
        call: signoz-serviceaccount.updateserviceaccount
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/service-accounts/{id}/keys
      name: api-v1-service-accounts-id-keys
      description: REST surface for api-v1-service_accounts-id-keys.
      operations:
      - method: GET
        name: listserviceaccountkeys
        description: List service account keys
        call: signoz-serviceaccount.listserviceaccountkeys
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createserviceaccountkey
        description: Create a service account key
        call: signoz-serviceaccount.createserviceaccountkey
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/service-accounts/{id}/keys/{fid}
      name: api-v1-service-accounts-id-keys-fid
      description: REST surface for api-v1-service_accounts-id-keys-fid.
      operations:
      - method: DELETE
        name: revokeserviceaccountkey
        description: Revoke a service account key
        call: signoz-serviceaccount.revokeserviceaccountkey
        with:
          id: rest.id
          fid: rest.fid
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: updateserviceaccountkey
        description: Updates a service account key
        call: signoz-serviceaccount.updateserviceaccountkey
        with:
          id: rest.id
          fid: rest.fid
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/service-accounts/{id}/roles
      name: api-v1-service-accounts-id-roles
      description: REST surface for api-v1-service_accounts-id-roles.
      operations:
      - method: GET
        name: getserviceaccountroles
        description: Gets service account roles
        call: signoz-serviceaccount.getserviceaccountroles
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: createserviceaccountrole
        description: Create service account role
        call: signoz-serviceaccount.createserviceaccountrole
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/v1/service-accounts/{id}/roles/{rid}
      name: api-v1-service-accounts-id-roles-rid
      description: REST surface for api-v1-service_accounts-id-roles-rid.
      operations:
      - method: DELETE
        name: deleteserviceaccountrole
        description: Delete service account role
        call: signoz-serviceaccount.deleteserviceaccountrole
        with:
          id: rest.id
          rid: rest.rid
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: signoz-serviceaccount-mcp
    port: 9090
    transport: http
    description: MCP adapter for SigNoz — serviceaccount. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: list-service-accounts
      description: List service accounts
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: signoz-serviceaccount.listserviceaccounts
      outputParameters:
      - type: object
        mapping: $.
    - name: create-service-account
      description: Create service account
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: signoz-serviceaccount.createserviceaccount
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: gets-my-service-account
      description: Gets my service account
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: signoz-serviceaccount.getmyserviceaccount
      outputParameters:
      - type: object
        mapping: $.
    - name: updates-my-service-account
      description: Updates my service account
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: signoz-serviceaccount.updatemyserviceaccount
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: deletes-service-account
      description: Deletes a service account
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: signoz-serviceaccount.deleteserviceaccount
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: gets-service-account
      description: Gets a service account
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: signoz-serviceaccount.getserviceaccount
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: updates-service-account
      description: Updates a service account
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: signoz-serviceaccount.updateserviceaccount
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: list-service-account-keys
      description: List service account keys
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: signoz-serviceaccount.listserviceaccountkeys
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: create-service-account-key
      description: Create a service account key
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: signoz-serviceaccount.createserviceaccountkey
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: revoke-service-account-key
      description: Revoke a service account key
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: signoz-serviceaccount.revokeserviceaccountkey
      with:
        id: tools.id
        fid: tools.fid
      outputParameters:
      - type: object
        mapping: $.
    - name: updates-service-account-key
      description: Updates a service account key
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: signoz-serviceaccount.updateserviceaccountkey
      with:
        id: tools.id
        fid: tools.fid
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: gets-service-account-roles
      description: Gets service account roles
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: signoz-serviceaccount.getserviceaccountroles
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: create-service-account-role
      description: Create service account role
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: signoz-serviceaccount.createserviceaccountrole
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-service-account-role
      description: Delete service account role
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: signoz-serviceaccount.deleteserviceaccountrole
      with:
        id: tools.id
        rid: tools.rid
      outputParameters:
      - type: object
        mapping: $.