PostHog API — project_secret_api_keys

naftiko: 1.0.0-alpha2
info:
  label: PostHog API — project_secret_api_keys
  description: 'PostHog API — project_secret_api_keys. 14 operations. Lead operation: project_secret_api_keys. Self-contained
    Naftiko capability covering one Posthog business surface.'
  tags:
  - Posthog
  - project_secret_api_keys
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    POSTHOG_API_KEY: POSTHOG_API_KEY
capability:
  consumes:
  - type: http
    namespace: posthog-project-secret-api-keys
    baseUri: ''
    description: PostHog API — project_secret_api_keys business capability. Self-contained, no shared references.
    resources:
    - name: api-environments-environment_id-project_secret_api_keys
      path: /api/environments/{environment_id}/project_secret_api_keys/
      operations:
      - name: environmentsprojectsecretapikeyslist
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: integer
          description: Number of results to return per page.
        - name: offset
          in: query
          type: integer
          description: The initial index from which to return the results.
      - name: environmentsprojectsecretapikeyscreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-environments-environment_id-project_secret_api_keys-id
      path: /api/environments/{environment_id}/project_secret_api_keys/{id}/
      operations:
      - name: environmentsprojectsecretapikeysretrieve
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A unique value identifying this project secret api key.
          required: true
      - name: environmentsprojectsecretapikeysupdate
        method: PUT
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A unique value identifying this project secret api key.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: environmentsprojectsecretapikeyspartialupdate
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A unique value identifying this project secret api key.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: environmentsprojectsecretapikeysdestroy
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A unique value identifying this project secret api key.
          required: true
    - name: api-environments-environment_id-project_secret_api_keys-id-roll
      path: /api/environments/{environment_id}/project_secret_api_keys/{id}/roll/
      operations:
      - name: environmentsprojectsecretapikeysrollcreate
        method: POST
        description: Roll a project secret API key
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A unique value identifying this project secret api key.
          required: true
    - name: api-projects-project_id-project_secret_api_keys
      path: /api/projects/{project_id}/project_secret_api_keys/
      operations:
      - name: projectsecretapikeyslist
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: limit
          in: query
          type: integer
          description: Number of results to return per page.
        - name: offset
          in: query
          type: integer
          description: The initial index from which to return the results.
      - name: projectsecretapikeyscreate
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: api-projects-project_id-project_secret_api_keys-id
      path: /api/projects/{project_id}/project_secret_api_keys/{id}/
      operations:
      - name: projectsecretapikeysretrieve
        method: GET
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A unique value identifying this project secret api key.
          required: true
      - name: projectsecretapikeysupdate
        method: PUT
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A unique value identifying this project secret api key.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
      - name: projectsecretapikeyspartialupdate
        method: PATCH
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A unique value identifying this project secret api key.
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: false
      - name: projectsecretapikeysdestroy
        method: DELETE
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A unique value identifying this project secret api key.
          required: true
    - name: api-projects-project_id-project_secret_api_keys-id-roll
      path: /api/projects/{project_id}/project_secret_api_keys/{id}/roll/
      operations:
      - name: projectsecretapikeysrollcreate
        method: POST
        description: Roll a project secret API key
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: A unique value identifying this project secret api key.
          required: true
    authentication:
      type: bearer
      token: '{{env.POSTHOG_API_KEY}}'
  exposes:
  - type: rest
    namespace: posthog-project-secret-api-keys-rest
    port: 8080
    description: REST adapter for PostHog API — project_secret_api_keys. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/api/environments/{environment-id}/project-secret-api-keys
      name: api-environments-environment-id-project-secret-api-keys
      description: REST surface for api-environments-environment_id-project_secret_api_keys.
      operations:
      - method: GET
        name: environmentsprojectsecretapikeyslist
        description: environmentsprojectsecretapikeyslist
        call: posthog-project-secret-api-keys.environmentsprojectsecretapikeyslist
        with:
          limit: rest.limit
          offset: rest.offset
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: environmentsprojectsecretapikeyscreate
        description: environmentsprojectsecretapikeyscreate
        call: posthog-project-secret-api-keys.environmentsprojectsecretapikeyscreate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/environments/{environment-id}/project-secret-api-keys/{id}
      name: api-environments-environment-id-project-secret-api-keys-id
      description: REST surface for api-environments-environment_id-project_secret_api_keys-id.
      operations:
      - method: GET
        name: environmentsprojectsecretapikeysretrieve
        description: environmentsprojectsecretapikeysretrieve
        call: posthog-project-secret-api-keys.environmentsprojectsecretapikeysretrieve
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: environmentsprojectsecretapikeysupdate
        description: environmentsprojectsecretapikeysupdate
        call: posthog-project-secret-api-keys.environmentsprojectsecretapikeysupdate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: environmentsprojectsecretapikeyspartialupdate
        description: environmentsprojectsecretapikeyspartialupdate
        call: posthog-project-secret-api-keys.environmentsprojectsecretapikeyspartialupdate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: environmentsprojectsecretapikeysdestroy
        description: environmentsprojectsecretapikeysdestroy
        call: posthog-project-secret-api-keys.environmentsprojectsecretapikeysdestroy
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/environments/{environment-id}/project-secret-api-keys/{id}/roll
      name: api-environments-environment-id-project-secret-api-keys-id-roll
      description: REST surface for api-environments-environment_id-project_secret_api_keys-id-roll.
      operations:
      - method: POST
        name: environmentsprojectsecretapikeysrollcreate
        description: Roll a project secret API key
        call: posthog-project-secret-api-keys.environmentsprojectsecretapikeysrollcreate
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/project-secret-api-keys
      name: api-projects-project-id-project-secret-api-keys
      description: REST surface for api-projects-project_id-project_secret_api_keys.
      operations:
      - method: GET
        name: projectsecretapikeyslist
        description: projectsecretapikeyslist
        call: posthog-project-secret-api-keys.projectsecretapikeyslist
        with:
          limit: rest.limit
          offset: rest.offset
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: projectsecretapikeyscreate
        description: projectsecretapikeyscreate
        call: posthog-project-secret-api-keys.projectsecretapikeyscreate
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/project-secret-api-keys/{id}
      name: api-projects-project-id-project-secret-api-keys-id
      description: REST surface for api-projects-project_id-project_secret_api_keys-id.
      operations:
      - method: GET
        name: projectsecretapikeysretrieve
        description: projectsecretapikeysretrieve
        call: posthog-project-secret-api-keys.projectsecretapikeysretrieve
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: projectsecretapikeysupdate
        description: projectsecretapikeysupdate
        call: posthog-project-secret-api-keys.projectsecretapikeysupdate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: projectsecretapikeyspartialupdate
        description: projectsecretapikeyspartialupdate
        call: posthog-project-secret-api-keys.projectsecretapikeyspartialupdate
        with:
          id: rest.id
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: projectsecretapikeysdestroy
        description: projectsecretapikeysdestroy
        call: posthog-project-secret-api-keys.projectsecretapikeysdestroy
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/api/projects/{project-id}/project-secret-api-keys/{id}/roll
      name: api-projects-project-id-project-secret-api-keys-id-roll
      description: REST surface for api-projects-project_id-project_secret_api_keys-id-roll.
      operations:
      - method: POST
        name: projectsecretapikeysrollcreate
        description: Roll a project secret API key
        call: posthog-project-secret-api-keys.projectsecretapikeysrollcreate
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: posthog-project-secret-api-keys-mcp
    port: 9090
    transport: http
    description: MCP adapter for PostHog API — project_secret_api_keys. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: environmentsprojectsecretapikeyslist
      description: environmentsprojectsecretapikeyslist
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-project-secret-api-keys.environmentsprojectsecretapikeyslist
      with:
        limit: tools.limit
        offset: tools.offset
      outputParameters:
      - type: object
        mapping: $.
    - name: environmentsprojectsecretapikeyscreate
      description: environmentsprojectsecretapikeyscreate
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-project-secret-api-keys.environmentsprojectsecretapikeyscreate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: environmentsprojectsecretapikeysretrieve
      description: environmentsprojectsecretapikeysretrieve
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-project-secret-api-keys.environmentsprojectsecretapikeysretrieve
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: environmentsprojectsecretapikeysupdate
      description: environmentsprojectsecretapikeysupdate
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: posthog-project-secret-api-keys.environmentsprojectsecretapikeysupdate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: environmentsprojectsecretapikeyspartialupdate
      description: environmentsprojectsecretapikeyspartialupdate
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: posthog-project-secret-api-keys.environmentsprojectsecretapikeyspartialupdate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: environmentsprojectsecretapikeysdestroy
      description: environmentsprojectsecretapikeysdestroy
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: posthog-project-secret-api-keys.environmentsprojectsecretapikeysdestroy
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: roll-project-secret-api-key
      description: Roll a project secret API key
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-project-secret-api-keys.environmentsprojectsecretapikeysrollcreate
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: projectsecretapikeyslist
      description: projectsecretapikeyslist
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-project-secret-api-keys.projectsecretapikeyslist
      with:
        limit: tools.limit
        offset: tools.offset
      outputParameters:
      - type: object
        mapping: $.
    - name: projectsecretapikeyscreate
      description: projectsecretapikeyscreate
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-project-secret-api-keys.projectsecretapikeyscreate
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: projectsecretapikeysretrieve
      description: projectsecretapikeysretrieve
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: posthog-project-secret-api-keys.projectsecretapikeysretrieve
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: projectsecretapikeysupdate
      description: projectsecretapikeysupdate
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: posthog-project-secret-api-keys.projectsecretapikeysupdate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: projectsecretapikeyspartialupdate
      description: projectsecretapikeyspartialupdate
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: posthog-project-secret-api-keys.projectsecretapikeyspartialupdate
      with:
        id: tools.id
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: projectsecretapikeysdestroy
      description: projectsecretapikeysdestroy
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: posthog-project-secret-api-keys.projectsecretapikeysdestroy
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: roll-project-secret-api-key-2
      description: Roll a project secret API key
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: posthog-project-secret-api-keys.projectsecretapikeysrollcreate
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.